On This Page

Home / Edge/ Cribl Edge on Linux/Install Edge on Linux via .deb

Install Edge on Linux via .deb

Install Cribl Edge in a Linux environment using a .deb package.

The installation conforms to restrictions for Linux installations, such as system requirements.

Install Cribl Edge from a .deb Package
​

Follow these steps to install an Edge Node on Linux from a .deb package:

  1. Download the Cribl Edge .deb package. Go to cribl.io/download and select the dropdown in the Software area labeled Select Release Version.

  2. Choose the Cribl Edge .deb version and type: <version> x64 Cribl Edge DEB, or <version> ARM Cribl Edge DEB.

  3. Select Download now.

  4. Open a CLI and run the following command to install the package with the apt utility:

    sudo apt install <path-to-deb-package>

    This command does the following:

    • Creates the cribl-edge user and group, if it doesn’t exist.
    • Puts the contents of the Cribl package into /opt/cribl-edge and makes root/root the owner.
    • Creates the cribl-edge systemd service, which is disabled by default.
    • Creates /etc/default/cribl-edge owned by cribl-edge:cribl-edge and only accessible by the cribl-edge user.
    • Creates /var/lib/cribl-edge/ owned by cribl-edge:cribl-edge and only accessible by the cribl-edge user.
    • Adds the Cribl Edge service definition file at /lib/systemd/system/cribl-edge.service.
    • Sets CRIBL_INSTALL_TYPE to DEB in the service definition, to block distributed upgrades, as upgrading from the Leader bypasses the security of a .deb package.
    • Sets CRIBL_VOLUME_DIR to /var/lib/cribl-edge in the service definition, so configs and logs are saved to the cribl-edge directory.

  5. Edit the environment variables in /etc/default/cribl-edge, so Cribl Edge can connect to a Leader. The .deb package installs cribl-edge in standalone mode by default (CRIBL_DIST_MODE = edge).


    To deploy Edge in a managed deployment, edit these environment variables:

    • CRIBL_DIST_MODE=managed-edge
    • CRIBL_DIST_LEADER_URL=tls://<authToken>@leader:4200

  6. During installation, the package configures but does not enable the systemd service. Enable the service:

    • sudo systemctl enable cribl-edge to enable the service to start on boot.
    • sudo systemctl start cribl-edge to start it manually.

To ensure that the cribl status command can run correctly when running via systemctl, set the CRIBL_VOLUME_DIR environment variable:

sudo bash
export CRIBL_VOLUME_DIR=/var/lib/cribl

Upgrade a .deb Installation
​

See Upgrade .deb Installations.

Uninstall a Cribl Edge .deb Package
​

To remove Cribl Edge that you installed from a .deb package, run:

sudo apt remove <path-to-deb-package>

Uninstalling removes the cribl-edge service, the cribl binary from /opt/, and the service file from /lib/systemd/system.

Configuration files are maintained, along with any environment variables you edited when you first installed Cribl. This means you can pull in your previous configuration(s) if you decide to reinstall Cribl via a .deb package.

The cribl-edge directory is also maintained, along with the data, logs, and defaults of your configuration.