Skip to content

Commit

Permalink
Merge pull request #2609 from OctopusDeploy/robe/linux-support
Browse files Browse the repository at this point in the history
Update linux requirements
  • Loading branch information
zentron authored Jan 23, 2025
2 parents 6cfafbc + 74dcc36 commit 27e573d
Showing 1 changed file with 24 additions and 14 deletions.
38 changes: 24 additions & 14 deletions src/pages/docs/infrastructure/deployment-targets/linux/index.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,19 @@
---
layout: src/layouts/Default.astro
pubDate: 2023-01-01
modDate: 2024-08-02
modDate: 2025-01-20
title: Linux targets
description: Configuring Linux servers as deployment targets in Octopus.
navOrder: 30
hideInThisSectionHeader: true
---

Linux servers can be configured as [deployment targets](/docs/infrastructure/deployment-targets) in Octopus.
Linux servers can be configured as [deployment targets](/docs/infrastructure/deployment-targets) in Octopus.

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

- Using the [Linux Tentacle](/docs/infrastructure/deployment-targets/tentacle/linux).
- Over SSH using an [SSH target](/docs/infrastructure/deployment-targets/linux/ssh-target).
- Over SSH using an [SSH target](/docs/infrastructure/deployment-targets/linux/ssh-target).

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

Expand All @@ -22,27 +23,36 @@ The Linux Tentacle is the recommended way to configure your server as a deployme
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](/docs/infrastructure/deployment-targets/tentacle/tentacle-communication/#polling-tentacles).
:::

## Requirements
## Dependencies

- The `$HOME` environment variable must be available.
- `bash` 3+ is available at `/bin/bash`.
- `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](/docs/infrastructure/deployment-targets/linux/ssh-requirements) and [Linux Tentacle](/docs/infrastructure/deployment-targets/tentacle/linux/#requirements).
There are additional dependency requirements to be aware of for both [SSH targets](/docs/infrastructure/deployment-targets/linux/ssh-requirements) and [Linux Tentacle](/docs/infrastructure/deployment-targets/tentacle/linux/#requirements).

These dependencies are not required if exclusively utilizing [Raw Scripts](https://octopus.com/docs/deployments/custom-scripts/raw-scripting).

## Supported distributions

The following platforms are explicitly supported (we run automated tests against them):
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](https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md#linux).

| OS | Versions |
|--------------------------------------------------------|------------------------|
| [Alpine](https://alpinelinux.org) | 3.20, 3.19, 3.18, 3.17 |
| [CentOS Stream](https://centos.org/) | 9 |
| [Debian](https://www.debian.org/) | 12, 11 |
| [Fedora](https://fedoraproject.org/) | 40, 39 |
| [openSUSE Leap](https://www.opensuse.org/) | 15.6, 15.5 |
| [Red Hat Enterprise Linux](https://access.redhat.com/) | 9, 8 |
| [SUSE Enterprise Linux](https://www.suse.com/) | 15.6, 15.5, 12.5 |
| [Ubuntu](https://ubuntu.com/) | 24.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.

- Ubuntu 22.04 LTS
- Redhat (RHEL) 8.10
- Amazon Linux 2
- Debian 11
- MacOS 12.6.3
- openSUSE 15.6
- SUSE LES 15 SP5
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

Expand Down

0 comments on commit 27e573d

Please sign in to comment.