# How to install Teamscale with Docker and docker-compose
We recommend running Teamscale with Docker and docker-compose. The images are available on Docker Hub (opens new window). Please note that we do not provide a latest tag.
To run Teamscale with Docker, you have to install Docker (opens new window) and docker-compose (opens new window).
docker-compose is included in the Docker installation.
Since Teamscale 8.3.0 at least version
20.10.10 of Docker is required.
docker version to check the installed version.
On Linux, please ensure that both
docker-compose are on your
PATH and can be run from your command line.
You must run all
docker-compose commands as
Either use a
root shell or prefix the commands with
docker version and verify that no errors are printed on the command line.
Use WSL 2 under Windows for Better Performance
When using Docker on Windows, running Docker from the Windows CLI has worse performance (opens new window) than running it from within the Windows Subsystem for Linux 2.
Within WSL 2, mounting folders from the Windows host's file system, e.g.
/mnt/c/, also has worse performance than mounting a WSL 2 path.
Thus, we recommend that you run Docker from within your WSL 2 Linux distribution of choice and store all Teamscale-related files inside the WSL Linux.
# Docker Compose Setup
We recommend a setup that contains NGINX as reverse proxy and two Teamscale instances. The second instance is used as shadow instance during updates. You can find a complete docker-compose based setup in our reference configuration (opens new window) on Github.