Linux targets

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.
  • tar is available. This is used to unpack Calamari.
  • base64 is available. This is used for encoding and decoding variables.
  • grep is available.

Any Linux server which meets these minimum requirements will be able to be configured as a deployment target or worker. However, there are additional requirements to be aware of for both SSH targets and Linux Tentacle.

Supported distributions

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

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

Learn more

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Tuesday, February 20, 2024