Operating systems
Which Linux distributions Deplo is tested on, which ones work, and which ones the installer refuses.
The same installer runs on the dashboard host and every server you add.
Requirements
| Requirement | Why |
|---|---|
Linux on x86-64 or arm64 | The agent binary and the control-plane image are published for these two only. |
systemd | Required for the agent. Without it, the control plane can start but the machine cannot run deployed 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 distributions
These are the safest choices for a first install.
| 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, not tested
The installer can set Docker up on these, but they are not tested choices.
| 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.
Bring your own Docker
These work when Docker and Compose v2 are already installed. The installer does not install Docker 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 normally. 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 before installing
The preflight changes nothing and prints blocking problems and warnings:
curl -fsSL https://deplo.build/install.sh | bash -s -- --checkSee also
Did this page help you?