Octopus Deploy Documentation

Linux targets

Last updated

Linux servers can be configured as deployment targets in Octopus.

The Octopus Server can communicate with Linux targets in two ways:

When using SSH for deployments to a Linux server, the Tentacle agent is not required and doesn't need to be installed.

The Linux Tentacle is the recommended way to configure your server as a deployment target. This allows you to secure the SSH port on your servers.

If you operate in a highly secure environment, where it's not possible to open an inbound TCP port for Tentacle (10933 by default), you can configure the Linux Tentacle in Polling mode.


  • The $HOME environment variable must be available.
  • bash 3+ is available at /bin/bash. (It does not need to be the user’s default shell.)
  • tar is available. This is used to unpack Calamari.
  • base64 is available. This is used for encoding and decoding variables.
  • grep is available.

Supported distributions

Any Linux server which meets the general requirements will be able to be configured as a deployment target. In addition, there are additional requirements for SSH targets and Linux Tentacle.

The following platforms are explicitly supported (we run automated tests against them):

  • Ubuntu 18.04 LTS
  • Ubuntu 16.04 LTS
  • Redhat (RHEL) 7.2
  • Centos 7.7
  • Amazon Linux 2
  • Debian 9.12
  • Fedora 23
  • MacOS 10.15.3
  • openSUSE 15.1
  • SUSE LES 12 SP5
  • FreeBSD 11.3

Learn more

Need support? We're here to help.