Skip to Content
Firstline/Docs

Install Docker

Which Docker version Firstline needs, the easiest way to get it, and how to check it.

Everything in Firstline runs in Docker containers, and Coolify itself runs on Docker.

Which version

Version
MinimumDocker Engine 24 or newer, with the Docker Compose v2 plugin. This is Coolify's requirement, and it also covers Firstline's needs (BuildKit builds and Compose v2 health-check dependencies)
Known goodDocker Engine 29.6.1 + Docker Compose v5.3.0 on Ubuntu 26.04 LTS, the combination Firstline's production server runs (checked Nov 2026)

Install Docker from Docker's official packages.

Don't use the snap package or Ubuntu's docker.io

Coolify doesn't support Docker installed through snap. Ubuntu's own docker.io package is also not the official build and often lags behind. If either is installed, remove it first (see the manual steps below).

Install it

On a fresh server you don't need to install Docker yourself. The Coolify installer installs Docker Engine from Docker's official packages when your distribution supports it, and configures logging and daemon settings for you.

Skip ahead to Install Coolify, then come back and run the checks below.

Check the installed version

Run these on the server, whichever way you installed:

docker version --format 'Engine {{.Server.Version}}'
docker compose version

You want Engine 24 or newer and a Compose v2+ plugin (the version string starts with v2 or higher, e.g. Docker Compose version v5.3.0).

If docker compose isn't found but docker-compose (with a hyphen) is, you have the old standalone Compose v1. Install the docker-compose-plugin package from Docker's repository instead.

Also check that Docker didn't come from snap:

snap list docker 2>/dev/null \
  && echo "Snap Docker found: remove it" \
  || echo "OK: not a snap install"

Upstream docs

On this page