Container Based Installation

Supported OS

To run the Instana Backend-Platform, the following Linux distributions are supported:

  • Ubuntu 16.04
  • Debian 9.x
  • RedHat 7.2+
  • CentOS 7.x
  • Amazon Linux 2.x

Supported Docker versions

  • 19.03
  • 18.03
  • 1.13


  • To authenticate against our Docker repository, please make sure the server can connect to
  • All installation and migration commands must be executed as root user.
  • You must have Docker installed. For more information on how to install Docker, see the Docker CE or Docker EE documentation.
  • Setup mount points and external volumes:

    • Data Stores (defaults to /mnt/data).
    • Cassandra, should not utilize the same volume for production installs (defaults to /mnt/metrics).
    • ClickHouse should not utilize the same volume for productions installs (defaults to /mnt/traces).
  • Logs (defaults to /var/log/instana). If required, you can create a different directory.

Fresh installation: single host

1. Install the Instana package

To install the Instana package on your machine, use the installation steps described below.


As root, execute the following lines, replacing <customer-agent-key> with your agent-key:

echo "deb [arch=amd64] https://_:<customer-agent-key> generic main" > /etc/apt/sources.list.d/instana-product.list
wget -qO - "" | apt-key add -
apt-get update
apt-get install instana-console


As root, execute the following lines, replacing <customer-agent-key> with your agent-key:

cat >/etc/yum.repos.d/Instana-Product.repo <<EOF
yum makecache -y fast
yum install -y instana-console --nogpgcheck

2. Install Instana

  1. To install Instana on your machine, run the following command:

    instana init

    Note: A settings.hcl file is generated in the same directory as where you run the instana init command.

  2. Select single (single host installation).

  3. Enter the following information:

    • Your tenant name and unit name.

    • Your agent key and sales key.

    • DNS name.

    • Path to your certificate files. If no path is defined, Instana generates a HTTPS TLS certificate for the UI (tls.crt) and key (tls.key) in the cert folder. If you would like to generate your own self-signed certificates, enter your hostname in the following command:

      openssl req -x509 -newkey rsa:2048 -keyout tls.key -out tls.crt -days 365 -nodes -subj "/CN=<hostname>"
  4. You can now sign in to Instana using the credentials displayed.

  5. Once Instana is deployed, activate your license.

Upgrade your package-based to container-based installation

instana containerize

Please create a backup of your data.

This command is only needed the first time to migrate from a package-based to a container-based install.

The following steps are executed automatically:

  1. Check for docker to be available
  2. Stop Instana
  3. Remove packages
  4. Download Docker Images
  5. Start Instana