Install Space with Docker Compose
Installation requirements
Host-machine platform: x86_64/amd64 or arm64.
Recommended host machine resources: 8 CPU cores, 12 GB memory.
Docker and Docker Compose 1.29.0 or later are installed on the host machine.
Install Space On-Premises with Docker Compose
Create and open an installation directory:
mkdir -p space-on-premises && cd space-on-premisesDownload the latest version of the
docker-compose.yml
file from https://assets.on-premises.service.jetbrains.space/. For example, if the latest version is 2024.2.2:export SPACE_RELEASE_NAME="2024.2.2" curl -O "https://assets.on-premises.service.jetbrains.space/${SPACE_RELEASE_NAME}/docker-compose.yml"Deploy the Docker Compose configuration:
docker-compose -p space-on-premises up -dImportant: Do not change the
space-on-premises
project name.Wait until the deployment is completed and make sure that all Space containers are up and running:
docker psOpen your Space On-Premises instance in a browser. The default URL is
http://127.0.0.1:8084
. The default administrator username isadmin
, the password isadmin
.Space components are accessible on the following URLs:
http://127.0.0.1:8084
: Space user interface.http://127.0.0.1:8080
: VCS API.ssh://127.0.0.1:2222
: VCS SSH.http://127.0.0.1:8390
: Packages API.
Perform post-installation administration activities:
If you want to use Space on mobile clients, configure push notifications.
If you want to use Space Automation (CI/CD), configure self-hosted Automation workers. Currently, Space On-Premises doesn't support cloud Automation workers.
If you want to use your Space instance in production, perform additional configuration: make your instance network-accessible and enable the mail server.
If you decide to use your own object storage instead of the default one, make sure to change its CORS policy to enable downloads in the Space Packages UI.
If you no longer need your Space installation, clean up the context:
docker-compose -p space-on-premises down -v docker-compose -p space-on-premises rm -f