Install JetBrains Fleet on a remote machine

You can install JetBrains Fleet on a remote machine for remote development. This addresses the case when you have a powerful box at home or in the office, and you want to use your local workstation as a thin client. This approach allows you to leverage higher compute capacity and avoid running heavy tasks locally.

Install

Download Fleet launcher binary
curl -LSs "https://download.jetbrains.com/product?code=FLL&release.type=preview&release.type=eap&platform=linux_x64" --output fleet && chmod +x fleet
curl -LSs "https://download.jetbrains.com/product?code=FLL&release.type=preview&release.type=eap&platform=linux_aarch64" --output fleet && chmod +x fleet
curl -LSs "https://download.jetbrains.com/product?code=FLL&release.type=preview&release.type=eap&platform=macos_x64" --output fleet && chmod +x fleet
curl -LSs "https://download.jetbrains.com/product?code=FLL&release.type=preview&release.type=eap&platform=macos_aarch64" --output fleet && chmod +x fleet
curl -LSs "https://download.jetbrains.com/product?code=FLL&release.type=preview&release.type=eap&platform=windows_x64" --output fleet.exe

After you have downloaded the binary, you can run it with a terminal command:

Run

Launch Fleet workspace using launcher
No authentication is provided, so anyone with the URL can access the workspace. Authentication modes other than accept-everyone will be available in future releases.
./fleet launch workspace -- --auth=accept-everyone --publish --enableSmartMode
The launch workspace command will auto-detect the implementation of libc used by your distribution. You can override this via the --libc-implementation flag.
./fleet launch workspace -- --auth=accept-everyone --publish --enableSmartMode
The launch workspace command will auto-detect the implementation of libc used by your distribution. You can override this via the --libc-implementation flag.
./fleet launch workspace -- --auth=accept-everyone --publish --enableSmartMode
./fleet launch workspace -- --auth=accept-everyone --publish --enableSmartMode
fleet.exe launch workspace -- --auth=accept-everyone --publish --enableSmartMode
Get the information to connect to this workspace in the first lines of the output. See the URL in this example output:
*** Starting Workspace Server *** - listening to 127.0.0.1:3500 - with FSD - with Backend - with UID: ea3b4b2a-528a-438a-a129-6737934375e7 - with HOST: dded2fa4-2673-4d5d-bcea-f98d56852f92 - version: 1.7.38 - URL: https://fleet.jetbrains.com/?version=1.9.237&workspaceId=ea3b4b2a-528a-438a-a129-6737934375e7 - Auth: {"type":"AcceptsEveryone"} - publish: true - lobby: LobbyAddress(host=lobby.fleet.api.jetbrains.com, isSecure=true, port=443)

For steps to uninstall Fleet from a remote machine, refer to Uninstall.

Command options

The command separates the options for the launcher and for the workspace. Use the following syntax:

./fleet launch workspace [launcher options] -- [workspace options]

Command example

./fleet launch workspace --workspace-version 1.9.117 -- --auth=accept-everyone --publish --enableSmartMode --projectDir=/tmp/myproject

In the above example:

--workspace-version 1.9.117 is a launcher option
--auth=accept-everyone --publish --enableSmartMode --projectDir=/tmp/myproject gets passed to the launched workspace

Launcher options

Option	Description
`--workspace-version <version>`	The version of Fleet workspace to launch. Defaults to the latest released version if not specified (using a network call). Version has to be specified in full format, for example: `1.19.95`

Workspace options

Option	Description
`--enableSmartMode` `--disableSmartMode`	Specifies if the Smart Mode should be enabled for the workspace at startup. By default, the workspace starts without the Smart Mode to minimize resource consumption. Set `--enableSmartMode` if you need the code intelligence features.
`--projectDir=PATH_TO_DIR`	Specifies a project directory to attach to the workspace at startup. This way, if `--smart-mode` flag is set to `enabled`, the available backends will be downloaded by the workspace and start indexing the directory content before the first user connects to the workspace.
`--workspaceHost=TEXT`	The host address on which the workspace will listen.
`--workspacePort=INT`	The port on which the workspace will listen.
`--publish` `--noPublish`	Specifies whether the workspace should be published to the JetBrains relay and be publicly accessible. Self-hosted remote workspaces (`--noPublish`) are not supported yet.
`--auth=[accept-everyone\|waiting-list\|oauth]`	The authorizers used by the workspace. Can be specified multiple times for supporting more than one authorizer. Authentication modes other than `accept-everyone` will be available in future releases.

Troubleshooting

If you encounter an issue, please file a bug report and attach the logs of your command with the --debug prefix. For example: ./fleet --debug launch workspace -- --auth=accept-everyone --publish --enableSmartMode

Last modified: 23 August 2023