linuxserver/docker-compose
This image is deprecated. We will not offer support for this image and it will not be updated. Docker Compose is now available from the docker repos: https://docs.docker.com/engine/install/
And also for direct download: https://github.com/docker/compose
The LinuxServer.io team brings you another container release featuring:
Find us at:
docker-compose is a tool for defining and running multi-container Docker applications. With Compose, you use a Compose file to configure your application's services. Then, using a single command, you create and start all the services from your configuration.
We utilise the docker manifest for multi-platform awareness. More information is available from docker here and our announcement here.
Simply pulling lscr.io/linuxserver/docker-compose:latest
should retrieve the correct image for your arch, but you can also pull specific arch images via tags.
The architectures supported by this image are:
Architecture | Available | Tag |
---|---|---|
x86-64 | ✅ | amd64-<version tag> |
arm64 | ✅ | arm64v8-<version tag> |
armhf | ✅ | arm32v7-<version tag> |
This image provides various versions that are available via tags. Please read the descriptions carefully and exercise caution when using unstable or development tags.
Tag | Available | Description |
---|---|---|
latest | ✅ | docker-compose v1 releases |
alpine | ✅ | docker-compose v1 releases with our alpine baseimage |
v2 | ✅ | docker compose v2 releases |
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
-v "$PWD:$PWD" \
-w="$PWD" \
lscr.io/linuxserver/docker-compose:latest \
up
You can replace the last line with any docker-compose command and argument, which will be passed to docker-compose inside the image.
We provide a very convenient script that allows the docker-compose container to run as if it was installed natively:
sudo curl -L --fail https://raw.githubusercontent.com/linuxserver/docker-docker-compose/master/run.sh -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
Running these two commands on your docker host once will let you issue commands such as docker-compose up -d
and the docker-compose container will do its job behind the scenes.
We publish various Docker Mods to enable additional functionality within the containers. The list of Mods available for this image (if any) as well as universal mods that can be applied to any one of our images can be accessed via the dynamic badges above.
docker exec -it docker-compose /bin/bash
docker logs -f docker-compose
docker inspect -f '{{ index .Config.Labels "build_version" }}' docker-compose
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/docker-compose:latest
Most of our images are static, versioned, and require an image update and container recreation to update the app inside. With some exceptions (ie. nextcloud, plex), we do not recommend or support updating apps inside the container. Please consult the Application Setup section above to see if it is recommended for the image.
Below are the instructions for updating containers:
docker pull lscr.io/linuxserver/docker-compose:latest
docker image prune
If you want to make local modifications to these images for development purposes or just to customize the logic:
git clone https://github.com/linuxserver/docker-docker-compose.git
cd docker-docker-compose
docker build \
--no-cache \
--pull \
-t lscr.io/linuxserver/docker-compose:latest .
The ARM variants can be built on x86_64 hardware using multiarch/qemu-user-static
docker run --rm --privileged multiarch/qemu-user-static:register --reset
Once registered you can define the dockerfile to use with -f Dockerfile.aarch64
.
DOCKER_COMPOSE_IMAGE_TAG
in the run.sh
script.alpine
tag.docker pull linuxserver/docker-compose