Before installing the Capsule8 Console, create a Postgres database for the console.
Minimum System Requirements
- 2 vCPUs
- 8 GB RAM
- 5 GB storage
We recommend a t2.large instance for deployments in EC2.
We actively test on the following Linux distributions:
- Debian 9, 10
- Ubuntu 16.04, 18.04, 19.04, 20.04
Capsule8 maintains an external package repository where deb packages are managed so that any user with an access token can install the correct packages for their system.
A read only token is used to authenticate with Capsule8’s repository host, PackageCloud. Access tokens are alpha numeric strings with no punctuation (eg.
Installation via the Capsule8 Package Repository
To Start, ensure that Capsule8 rep has provided you with the Access Token to the Capsule8 Package Repository. Using the access token, the local system must be updated to enable package installation.
This is performed by substituting your access token and running the command below:
curl -s https://<package-cloud-token>:@packagecloud.io/install/repositories/capsule8/capsule8/script.deb.sh | sudo bash
Once the local system is updated to pull Capsule8’s packages, they can be installed using the system’s native package installer.
Providing a Console version is optional. The most recent version available will be installed by default.
Here is an example of installing the Capsule8 Console version
sudo apt-get install capsule8-console-systemd=4.6.2
Configure the Console
Follow instructions in our configuration guide to create a configuration file and connect the console to the Postgres database.
Enable and start the Capsule8 Console
To enable the newly installed Console
sudo systemctl enable capsule8-console
sudo systemctl start capsule8-console
Monitoring the Capsule8 Console
To make sure the Console is running, check its status:
sudo systemctl status capsule8-console
To view logs and other output:
sudo journalctl -efu capsule8-console