Agent Installation

Sysdig agents are delivered as either a container or a service and can be deployed with or without an orchestrator such as Kubernetes or Mesos.

A quick install involves just a few lines of code from the Getting Started Wizard copied into a shell. The complete install instructions address checking for and installing kernel headers if needed, any prerequisite permissions settings for particular environments, and tips about updating the configuration files after initial installation.

Plan the Installation

Topic

Description

Host Requirements

Review the platforms, runtimes, Linux distributions, orchestration, browsers, etc. that are supported.

Kernel Header Troubleshooting

Additional tips if your kernel module or header are not automatically compiled by the agent

Access key

An agent access key is provided with a Sysidg trial

Install Options

Wizard-Based

With the Getting Started Wizard, you can copy/paste a simple line of code to deploy agents in a variety of environments. Behind the scenes, the Wizard auto-detects and completes configuration items such as the required access key and port information. The Wizard is launched from the Start a Free Trial button at sysdig.com.

After the first install, Sysdig Secure users can access the Wizard at any time from the Rocket icon in the navbar.

Manual Options

There are a variety of ways to install agents without using the Wizard.

Flavor

Helm

Manual

Notes

Kubernetes

Vanilla

Readme

Kubernetes vanilla

Used most environments, e.g. Amazon EKS, EC2, Azure AKS, etc.

GKE

Readme

GKE

Used for Google Kubernetes Service environment

OpenShift

Readme

OpenShift

Used for any environment with OpenShift

Non-Orchestrated

Agent as container or agent as service

n/a

Container

Service

Used when there is no orchestrator such as Kubernetes

IKS

n/a

IBM Cloud with Sysdig)

IBM manages and documents Sysdig installs as part of IKS.

Certain environments may need a different option: