Skip to content

Commit 27e573d

Browse files
authored
Merge pull request #2609 from OctopusDeploy/robe/linux-support
Update linux requirements
2 parents 6cfafbc + 74dcc36 commit 27e573d

File tree

1 file changed

+24
-14
lines changed
  • src/pages/docs/infrastructure/deployment-targets/linux

1 file changed

+24
-14
lines changed

src/pages/docs/infrastructure/deployment-targets/linux/index.md

Lines changed: 24 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2023-01-01
4-
modDate: 2024-08-02
4+
modDate: 2025-01-20
55
title: Linux targets
66
description: Configuring Linux servers as deployment targets in Octopus.
77
navOrder: 30
88
hideInThisSectionHeader: true
99
---
1010

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

1313
The Octopus Server can communicate with Linux targets in two ways:
14+
1415
- Using the [Linux Tentacle](/docs/infrastructure/deployment-targets/tentacle/linux).
15-
- Over SSH using an [SSH target](/docs/infrastructure/deployment-targets/linux/ssh-target).
16+
- Over SSH using an [SSH target](/docs/infrastructure/deployment-targets/linux/ssh-target).
1617

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

@@ -22,27 +23,36 @@ The Linux Tentacle is the recommended way to configure your server as a deployme
2223
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).
2324
:::
2425

25-
## Requirements
26+
## Dependencies
2627

2728
- The `$HOME` environment variable must be available.
28-
- `bash` 3+ is available at `/bin/bash`.
29+
- `bash` 3+ is available at `/bin/bash`
2930
- `tar` is available. This is used to unpack Calamari.
3031
- `base64` is available. This is used for encoding and decoding variables.
3132
- `grep` is available.
3233

33-
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).
34+
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).
35+
36+
These dependencies are not required if exclusively utilizing [Raw Scripts](https://octopus.com/docs/deployments/custom-scripts/raw-scripting).
3437

3538
## Supported distributions
3639

37-
The following platforms are explicitly supported (we run automated tests against them):
40+
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).
41+
42+
| OS | Versions |
43+
|--------------------------------------------------------|------------------------|
44+
| [Alpine](https://alpinelinux.org) | 3.20, 3.19, 3.18, 3.17 |
45+
| [CentOS Stream](https://centos.org/) | 9 |
46+
| [Debian](https://www.debian.org/) | 12, 11 |
47+
| [Fedora](https://fedoraproject.org/) | 40, 39 |
48+
| [openSUSE Leap](https://www.opensuse.org/) | 15.6, 15.5 |
49+
| [Red Hat Enterprise Linux](https://access.redhat.com/) | 9, 8 |
50+
| [SUSE Enterprise Linux](https://www.suse.com/) | 15.6, 15.5, 12.5 |
51+
| [Ubuntu](https://ubuntu.com/) | 24.04, 22.04, 20.04 |
52+
53+
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.
3854

39-
- Ubuntu 22.04 LTS
40-
- Redhat (RHEL) 8.10
41-
- Amazon Linux 2
42-
- Debian 11
43-
- MacOS 12.6.3
44-
- openSUSE 15.6
45-
- SUSE LES 15 SP5
55+
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.
4656

4757
## Learn more
4858

0 commit comments

Comments
 (0)