JetBrains Fleet 1.22 Help

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.


  • Download Fleet launcher binary

    curl -LSs "" --output fleet && chmod +x fleet
    curl -LSs "" --output fleet && chmod +x fleet
    curl -LSs "" --output fleet && chmod +x fleet
    curl -LSs "" --output fleet && chmod +x fleet
    curl -LSs "" --output fleet.exe

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


  1. Launch Fleet workspace using launcher

    ./fleet launch workspace -- --auth=accept-everyone --publish --enableSmartMode
    ./fleet launch workspace -- --auth=accept-everyone --publish --enableSmartMode
    ./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
  2. 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 - with FSD - with Backend - with UID: ea3b4b2a-528a-438a-a129-6737934375e7 - with HOST: dded2fa4-2673-4d5d-bcea-f98d56852f92 - version: 1.7.38 - URL: - Auth: {"type":"AcceptsEveryone"} - publish: true - lobby: LobbyAddress(, 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



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





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.


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.


The host address on which the workspace will listen.


The port on which the workspace will listen.



Specifies whether the workspace should be published to the JetBrains relay and be publicly accessible.


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.


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