2. Install Docker Engine & Docker Compose

We will install docker and docker-compose. If you already have docker installed, you should still read this part as it contains important information about DNS configuration.


Minimal versions: docker 1.17, docker-compose 1.10

2.1. Install Docker Engine

2.1.1. Installing Docker on Ubuntu

Follow the official Docker documentation: Installation on Ubuntu.

2.1.2. Installing Docker on Fedora

Fedora 24+

See also the official Docker documentation: Installation on Fedora.

# Install the dnf-plugins-core package
$ sudo dnf -y install dnf-plugins-core

# Set up the stable repository
$ sudo dnf config-manager \
    --add-repo \

# Install the latest version of Docker CE
$ sudo dnf install docker-ce

# Start the docker daemon
$ sudo systemctl start docker

# Make the docker daemon start at boot
$ sudo systemctl enable docker

# Add yourself to the docker group to enable running docker commands
# without prefixing with sudo i
$ sudo groupadd docker
$ sudo chown root:docker /var/run/docker.sock
$ sudo usermod -a -G docker $USERNAME

You can ensure docker is working properly by using $ docker run hello-world.

2.1.3. Installing Docker on macOS

Go to https://docs.docker.com/docker-for-mac/ and download Docker for Mac. It will install all you need to run Tuleap containers.

2.2. Install Docker Compose

Once docker is installed, you must install docker-compose. Follow steps on Docker Compose documentation.


There is no need to manually install docker-compose on macOS since it has already been installed via Docker for Mac.