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.

Dependencies

  • 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.

There are additional dependency requirements to be aware of for both SSH targets and Linux Tentacle.

These dependencies are not required if exclusively utilizing Raw Scripts.

Supported distributions

Since tooling used to invoke Octopus workloads is based on .NET 6, Octopus Server supports running workloads on the following distributions as per the .NET 6 supported platform details.

OSVersions
CentOS Stream9
Debian12, 11
Fedora40, 39
openSUSE Leap15.6, 15.5
Red Hat Enterprise Linux9, 8
SUSE Enterprise Linux15.6, 15.5, 12.5
Ubuntu24.04, 22.04, 20.04

Although the tooling requires the platform to support .NET Core, since it runs as a self-contained .NET deployment there is no .NET installation prerequisite.

In addition to the .NET 6 requirement, Octopus will only support those Operating Systems which are themselves still considered as supported by the platform vendors themselves.

Learn more

Help us continuously improve

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

Send feedback

Page updated on Monday, January 27, 2025