Operating systems
Which Linux distributions Deplo is tested on, which ones work, and which ones the installer refuses.
Deplo installs from one shell script, and the same script runs on the machine that hosts the dashboard and on every server you add to the fleet. The requirements below are the same for both.
What the installer requires
| Requirement | Why |
|---|---|
Linux on x86-64 or arm64 | The agent binary and the control-plane image are published for these two only. |
systemd | The agent runs as a systemd unit. Without it the machine cannot run apps. |
| Root, for the length of one command | It writes a system service and installs packages. |
curl and sha256sum | To download the agent and verify its checksum before running it. |
| Docker with Compose v2 | Installed for you when your distribution is one Docker publishes packages for. |
Tested
Deplo is installed and exercised on these. They are the safe pick.
| OS | Status | Notes |
|---|---|---|
| Ubuntu 26.04 LTS | Tested | Supported by Canonical until 2031. |
| Ubuntu 24.04 LTS | Tested | Supported until 2029. |
| Debian 13 (trixie) | Tested | Current stable. |
| Debian 12 (bookworm) | Tested | Oldstable, LTS until June 2028. |
Compatible
The installer sets Docker up on its own here, and nothing in Deplo is distribution-specific. We have not run the platform on them, so they are not the pick for your first install.
| OS | Status | Notes |
|---|---|---|
| Ubuntu 22.04 LTS | Compatible | Older Docker, everything else identical. |
| Fedora 43 and 44 | Compatible | A Fedora release goes end of life in about 13 months, so plan the upgrade. |
| Rocky Linux 9 and 10 | Compatible | firewalld holds 9443 shut; the installer prints the command to open it. |
| CentOS Stream 9 and 10 | Compatible | Same firewall note. |
| RHEL 9 and 10 | Compatible | Same firewall note. |
| Raspberry Pi OS 64-bit | Compatible | The 32-bit image will not work, see below. |
Version 8 of the RHEL family
Rocky, AlmaLinux, CentOS and RHEL 8 still install, but they boot on cgroup v1 and Deplo reads container metrics from cgroup v2. Everything deploys, the Monitoring charts stay empty.
Works, once you install Docker
These run Deplo fine. What they do not do is get Docker from the installer: it asks Docker's own install script, which does not publish packages for them.
| OS | Status | Notes |
|---|---|---|
| AlmaLinux 9 and 10 | Bring your own Docker | Takes the CentOS packages, built against the same release. |
| openSUSE Leap 15 | Bring your own Docker | Docker and Compose v2 are in its own repositories. |
| Arch Linux | Bring your own Docker | Docker and Compose v2 are in extra. |
| Any other distribution with systemd | Bring your own Docker | docker compose version has to answer 2.x or newer. |
Install Docker first, then run the Deplo command as normal - it detects Docker and skips that step.
dnf -y install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
systemctl enable --now dockerThe one thing to check afterwards is docker compose version. Deplo needs the Compose plugin,
version 2 or newer, not the old standalone docker-compose binary.
Not supported
| OS | Status | Why |
|---|---|---|
| Alpine Linux | Not supported | No systemd. The agent is a systemd unit, so the preflight refuses before anything is installed. |
| SUSE Linux Enterprise | Not supported | Docker publishes docker-ce for SLES on IBM Z only. There is no x86-64 or arm64 package to install. |
32-bit Linux (armhf, i386) | Not supported | The agent binary is published for amd64 and arm64 only. This is the 32-bit Raspberry Pi OS image. |
| Windows, macOS | Not supported | Deplo runs Linux containers on a Linux host. |
arm64 is published, not tested
Deplo publishes an arm64 agent and an arm64 image, and the installer accepts the
architecture. Nothing in the platform is x86-64-specific, but we have not run a fleet on ARM,
so treat it as compatible rather than proven.
Check a machine before you commit to it
The preflight changes nothing on the host and prints every blocking problem and every warning:
curl -fsSL https://deplo.build/install.sh | bash -s -- --checkDid this page help you?