Installing the Console via Debian/Ubuntu package

Prerequisites

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.

Supported Platforms

We actively test on the following Linux distributions:

• Debian 9, 10
• Ubuntu 16.04, 18.04, 19.04, 20.04

Access token

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. abcdef012314f29dc850878c6747b70f5b3ff01234567891092f0).

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

Package Installation

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  4.6.2 :

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