How to install Teamscale with Docker using Docker Compose
We recommend running Teamscale with Docker using Docker Compose. The images are available on Docker Hub. Please note that we do not provide a latest tag.
Prerequisites
To run Teamscale with Docker, you have to install Docker and the Docker Compose Plugin.
Minimal Version
Teamscale requires at least version 20.10.13 of Docker. Run docker version to check the installed version.
On Linux, please ensure that docker is on your PATH and can be run from your command line. You must run all docker commands as root. Either use a root shell or prefix the commands with sudo.
Run 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 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 setup based on Docker Compose in our reference configuration on Github.