Sysdig Install: Linux (Manual)

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 install instructions:  Sysdig Agent Install Overview

NOTE: Run the commands as root or with sudo

Debian, Ubuntu

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

    curl -s https://s3.amazonaws.com/download.draios.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. Please 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 Linux

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

    rpm --import https://s3.amazonaws.com/download.draios.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
    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. Please 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 and Fedora 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

 

Infrastructure Integrations

If you are installing the Sysdig agent in an orchestrated infrastructure such as Kubernetes, Mesos/Marathon, AWS ECS and etc., please also see the agent integration section of our user guide for additional information and examples: Agent-Integration

 

Have more questions? Submit a request