- Capsule8 Console version 4.4.1 or greater
- The Package Cloud token should be set in the Console Configuration with the
- To use "Quick Install", enable Console control of the Capsule8 Sensor with the
After the installation, if the console doesn't detects any hosts, the user will be prompted with a pop up as below.
User has the option to select either Manual Install or Quick Install to set up the sensor from the Console UI. Capsule8 recommend to use Quick Install.
Quick Installation of Sensors from Console UI
If Quick Install is selected, user will be presented with the below steps.
To open a shell , you can either search "terminal" or press CTRL+ALT+T on your keyboard. Enter the command
and press Enter.
username: Please use the username that has been provided to you and in case of any concerns, please contact Capsule8
host_ip_address: You should be using the ip address of the host on which the sensor will be installed.
Type in your password when prompted and press Enter. When you are connecting to the server for the first time it will ask if you want to continue connecting. Type yes and press Enter.
Once the shell is open and running, press Next on the console UI.
Once you are connected to the host, follow the instructions on step 2.
Copy and paste the script(similar to the below example) to the shell and press Enter. Enter the password and press Enter when prompted to continue.
echo "$(curl -sS 'https://capsule8.mycompany.com/install.sh?token=eyJhbGciOiJIUcN7NiIsInR5cCI6IkpXVCJ9.eyJjcmVhdGVBbGVydHMiOnRydWUsImV4cCI6MTkxNjg1NjQxMywiaWF0IjoxNjAxNDk2NDEzLCJpZCI6MSwicmVzdHJpY3RlZCI6dHJ1ZSwidmlld1BvbGljaWVzIjp0cnVlfQ.ebHRvlUB8IxfePi3W9g9sg1o59uRqhNj9xfO7_tZk3I')" |sudo bash
When the installation is successful, press Next on the console UI and below screen will be displayed.
Press Finish to complete the installation and you will be redirected to the Resources page, where the host will be listed on which the sensor was installed. Please follow the instructions on this document to generate a test alert to verify the installation.
Manual Installation of Sensors from Console UI
If Manual Install is selected, user will be presented with the below step
To add a new Sensor to this instance of the Console, copy the the info from the text box(an example is given below) into your
- type: blobstorage
aws_access_key_id: "<PLACE YOUR ACCESS KEY ID HERE>"
aws_secret_access_key: "<PLACE YOUR SECRET ACCESS KEY HERE>"
Replace the AWS key and secret with the key and secret that has s3:CreateBucket and s3:PutObject permissions on this bucket. Please follow the instructions on this document to generate a test alert to verify the installation.