JetBrains Space Help

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

  1. Create and open an installation directory:

    mkdir -p space-on-premises && cd space-on-premises
  2. Download 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.1.0:

    export SPACE_RELEASE_NAME="2024.1.0" curl -O "https://assets.on-premises.service.jetbrains.space/${SPACE_RELEASE_NAME}/docker-compose.yml"
  3. Deploy the Docker Compose configuration:

    docker-compose -p space-on-premises up -d

    Important: Do not change the space-on-premises project name.

  4. Wait until the deployment is completed and make sure that all Space containers are up and running:

    docker ps
  5. Open your Space On-Premises instance in a browser. The default URL is http://127.0.0.1:8084. The default administrator username is admin, the password is admin.

    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.

  6. Perform post-installation administration activities:

  7. If you want to use your Space instance in production, perform additional configuration: make your instance network-accessible and enable the mail server.

  8. 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.

  9. 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
Last modified: 08 April 2024