Docker Compose Quickstart#

Here are some minimal setup instructions to get you up and running with docker-compose and a container runtime on any platform. We recommend podman as the container runtime; if you would rather use docker see Using Docker Instead of Podman.

Podman Already Installed#

If you have any Linux distribution with podman and docker-compose installed you are all set.

Linux#

Debian Distros

sudo apt update
sudo apt install podman docker-compose-v2

RPM Distros

sudo dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
sudo dnf install podman docker-compose-plugin

Podman Integration with Docker Compose

systemctl enable --user podman.socket --now
export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/podman/podman.sock

Windows#

PowerShell: wsl --install -d Ubuntu
Open Ubuntu terminal and follow Linux

Mac OS#

Follow this gist https://gist.github.com/kaaquist/dab64aeb52a815b935b11c86202761a3
Install an X11 server like XQuartz

Diamond Light Source workstation#

Setup a podman service and socket:

systemctl enable --user podman.socket --now

Add this to your ~/.profile and logout and back in:

export PATH=/dls_sw/apps/docker-compose/5.1.4/bin/:$PATH
export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/podman/podman.sock

NOTE: re above. You should first do ls /dls_sw/apps/docker-compose/ to check which is the most recent version of docker-compose available. Use that version in preference to the example above.