Sysdig Documentation

Agent Install: Manual Linux Installation

Manual installation of the native Linux agent is recommended in the following cases:

  • Full control over the deployment process

  • Integration with configuration management tools

  • Custom kernel

  • Unsupported distribution (within Debian/Fedora flavors)

Otherwise, you may want to just follow the standard Installation Guide:

NOTE: If you are installing the Sysdig agent in an orchestrated infrastructure such as Kubernetes, Mesos/Marathon, use the respective Installation Guides:

Note

Run the commands as root or with sudo.

Installation Options

Review the Host Requirements for Agent Installation. Then follow the steps for the appropriate Linux distribution, below.

Debian, Ubuntu

  1. Trust the Sysdig Monitor GPG key, configure the apt repository, and update the package list:

    curl -s https://download.sysdig.com/DRAIOS-GPG-KEY.public | apt-key add -
    curl -s -o /etc/apt/sources.list.d/draios.list http://download.draios.com/stable/deb/draios.list
    apt-get update
  2. Install kernel development files.

    Warning

    The following command might not work with every kernel. Make sure to customize the name of the package properly.

    apt-get -y install linux-headers-$(uname -r)
  3. Install, configure, and restart the Sysdig agent.

    apt-get -y install draios-agent
    echo customerid: ACCESS_KEY >> /opt/draios/etc/dragent.yaml
    echo tags: [TAGS] >> /opt/draios/etc/dragent.yaml
    service dragent restart

    Replace ACCESS_KEY with your unique access key string. Contact support@sysdig.com to receive (or be reminded of) your access key. [TAGS] is an optional parameter you can use to list one or more tags for this host (see below).

CentOS, RHEL, Fedora, Amazon AMI, Amazon Linux 2

  1. Trust the Sysdig Monitor GPG key, configure the yum repository.

    rpm --import https://download.sysdig.com/DRAIOS-GPG-KEY.public
    curl -s -o /etc/yum.repos.d/draios.repo http://download.draios.com/stable/rpm/draios.repo
  2. Install the EPEL repository

    Note

    The following command is required only if DKMS is not available in the distribution. You can verify if DKMS is available with yum list dkms

    The command below contains a sample release number; be sure to update with the correct release.

    rpm -i http://mirror.us.leaseweb.net/epel/6/i386/epel-release-6-8.noarch.rpm
  3. Install kernel development files.

    Warning

    The following command might not work with every kernel. Make sure to customize the name of the package properly.

    yum -y install kernel-devel-$(uname -r)
  4. Install, configure, and start the Sysdig agent.

    yum -y install draios-agent
    echo customerid: ACCESS_KEY >> /opt/draios/etc/dragent.yaml
    echo tags: [TAGS] >> /opt/draios/etc/dragent.yaml
    service dragent start

    Replace ACCESS_KEY with your unique access key string. Contact support@sysdig.com to receive (or be reminded of) your access key. [TAGS] is an optional parameter you can use to list one or more tags for this host (see below).

Other Linux Distributions

The Sysdig Agent is unsupported outside of the Debian, Fedora, and Amazon distributions.

Agent Tags

Tagging your hosts is highly recommended. Agent Tags allow you to sort nodes of your infrastructure into custom groups in Sysdig Monitor.

Replace the [TAGS] parameter above with a comma-separated list of TAG_NAME:TAG_VALUE .

For example: role:webserver,location:europe