Architecture overview and on-premises server quick setup
The Code With Me feature enables you to share an open project in your IDE with your distributed team. You can set up on-premises servers to have full control of your infrastructure while working with Code With Me.
A host is either the instance of the IntelliJ IDEA based IDE which shares its coding environment with clients or the person doing that.
A guest is either the instance that is connected to the Code With Me coding session shared by the host or the person joining the session.
- IntelliJ Client
A client is a lightweight version of IntelliJ IDEA, used by a guest for connecting to the host.
- Lobby server
A lobby server is responsible for the following actions:
Generating a link that can be used to join the Code With Me session.
Reporting a list of supported features to the host or a guest (for example, whether P2P is allowed or not).
Selecting a relay server in cases when P2P does not work or is forbidden.
- Relay server
A relay server is responsible for relaying a connection between the host or guests in case the P2P connection doesn't work or is forbidden. It is possible to have several relays in different locations, and to choose the closest one based on the proximity.
Initiate a Code With Me session
The host requests a Code With Me session creation from the lobby server.
The lobby server creates a Code With Me session, which is persisted and can be joined until the host closes the session.
The lobby server sends a Code With Me join link to the host, and can be shared with potential guests.
Join a Code With Me session
A guest opens a Code With Me join link.
A lobby server provides the guest with the required version of IntelliJ Client.
IntelliJ Client is launched and connects to the session (either using P2P or relays, depending on the companies' policies and P2P availability).
The Code With Me setup
The quick Code With Me setup is intended for quick evaluation purposes. This setup is also highly insecure for the production use based on the following limitations:
The setup doesn't have SSL for lobby or relay servers connections.
The relay server cannot verify whether the requests to establish a relay are authentic and coming from the real lobby server.
The relay server or the host cannot verify whether session join request is signed by the lobby server.
Set up launcher
- Follow this link for the setup launcher.
Quick setup uses a single-click executable for the Code With Me servers.
You can use the following options in the code to launch the servers for the Code With Me session:
The host address is specified by the
Path to the license file is specified by the
-koption. To obtain the license file, go to https://www.jetbrains.com/code-with-me/on-prem/
- The lobby and relay server ports can be specified using the
The servers default to
2093for a lobby server and
3274for a relay server.
Enter the following command:
$./launch.sh -h 10.2.2.53 -k license.key
This command launches a lobby server, accessible via the address http://10.2.2.53:2093. This command also launches a relay server on the port
3274, and the lobby server will share a link of ws://10.2.2.53:3274 as the relay address.
Enter the following command:
$./launch.sh -h myserver.internal -k license.key -l 4950 -r 8092
This command launches a lobby server, accessible via the address http://myserver.internal:4950.
This command also launches a relay server on the port
8092, and the lobby will share a link of ws://myserver.internal:8092 as the relay address.
The offline mode setup
You can set up Code With Me without connecting to the JetBrains site.
Set up Code With Me
Download required files from the JetBrains sites on the machine where there is an Internet connection, place them somewhere, and point the lobby server to use this place as the local storage.
- Somewhere on the machine with Internet access, run the single separate "mirror_guests" script (
lobby/bin/mirror-guests) with required filters and versions.
Use the following example:.bin/mirror-guests" --verbose --products-filter IU --platforms-filter windows-x64 --build-filter 211.7142.45 /tmp/CWMsources
/tmp/CWMsourcesare examples, adjust those parts of code accordingly.
Place saved files to the machine where you don't have the Internet connection and where the quick-setup will be tested. The folder with files will be considered as
Add following entries to the
launch.shscript:export GUESTS_LOCAL_STORAGE=true export GUESTS_LOCAL_STORAGE_DIRECTORY=
The value of
GUESTS_LOCAL_STORAGE_DIRECTORY=is equal to the place from previous step.