IDE Services installation
Last modified: 21 March 2025IDE Services is available under a proprietary agreement (EULA) and consists of three main components: the IDE Services Server, Toolbox App, and JetBrains IDE Services Plugin for IntelliJ-based IDEs. Each of these components has its separate installation method and requirements.
IDE Services Server
The IDE Services Server is the core component of IDE Services that is installed within your company's infrastructure.
You can use the means of Kubernetes, Docker, or Docker Compose to start the IDE Services Server.
For production use, it is recommended to deploy the server in a highly available and fault-tolerant setup. For proper functioning, the IDE Services Server requires the following infrastructure:
PostgreSQL database 13+
Object Storage (an S3-compatible bucket or Azure Blob Storage)
External authentication service (Google, Okta, or similar)
Start the IDE Services Server in a Docker container
One of the distribution options for IDE Services is a Docker image from the registry:
docker.io/jetbrains/ide-services:2025.1.0.2151Make sure that you have all parts of the required infrastructure up and running. This includes a PostgreSQL database, object storage, and configured authentication provider.
Configure the application.yaml file.
Provide values for the parameters of the
server.sslgroup or ensure that your server is capable of upgrading the network traffic to HTTPS.Run the following command to start the Docker container:
LinuxmacOSWindowsdocker run -it \ -v `pwd`/application.yaml:/config/application.yaml \ -e SPRING_CONFIG_ADDITIONAL-LOCATION=/config/application.yaml \ -p 80:8080 \ docker.io/jetbrains/ide-services:2025.1.0.2151docker run -it \ -v `pwd`/application.yaml:/config/application.yaml \ -e SPRING_CONFIG_ADDITIONAL-LOCATION=/config/application.yaml \ -p 80:8080 \ docker.io/jetbrains/ide-services:2025.1.0.2151docker run -it ^ -v `pwd`/application.yaml:/config/application.yaml ^ -e SPRING_CONFIG_ADDITIONAL-LOCATION=/config/application.yaml ^ -p 80:8080 ^ docker.io/jetbrains/ide-services:2025.1.0.2151The IDE Services Server starts in a Docker container. Open
https://<server_domain>or, in case of local deployment,https://localhost:8080in your browser to log in to the IDE Services Web UI.
note
The Docker image may include additional software subject to separate licenses. Dockerfiles to build IDE Services images are available in the official GitHub repository.
Start the IDE Services Server using binaries
Before start:
Install Java version 17 or later (for example, openjdk-17-jre).
Make sure that you have all parts of the required infrastructure up and running. This includes a PostgreSQL database, object storage, and configured authentication provider.
Download the tbe-launcher-2025.1.0.2151.tar archive.
Unpack the archive to a new installation directory.
Export an environmental variable with the path to application.yaml. For example:
export SPRING_CONFIG_ADDITIONAL_LOCATION=`pwd`/application.yamlRun the following script to start the server:
Linux/macOSWindows/tbe-launcher-2025.1.0.2151 /bin /tbe-launcher /tbe-launcher-2025.1.0.2151 /bin /tbe-launcher.bat
Toolbox App
The Toolbox App is an application that is installed on developer machines and used for downloading, updating, and configuring IntelliJ-based IDEs. The Toolbox App serves as an agent to deliver IDEs and configurations to developer machines.
The application is provided as an installer for Windows, macOS, or Linux. It is required to use version 2.5.1.34629 or newer. For more information, see the Toolbox App and EULA agreement.
tip
Installing and using the Toolbox App is required to support the features of all IDE Services products except License Vault. However, if your organization uses License Vault only, it is possible to bypass the Toolbox App installation and activate IDEs directly through the License Server.
JetBrains IDE Services Plugin for IntelliJ-based IDEs
The JetBrains IDE Services Plugin for IntelliJ-based IDEs facilitates the implementation of IDE Services features.
Available on JetBrains Marketplace, the JetBrains IDE Services plugin seamlessly integrates with IntelliJ-based IDEs and is installed automatically.