Connect to a workspace

You can connect to a remote workspace from Fleet, or from a browser using the workspace URL.

From a browser

In your browser, open the workspace URL.
Give the permission for the browser to open JetBrains Toolbox. Wait until the connection is set up.

If JetBrains Fleet is already running, you can use the Join Session action.

From JetBrains Fleet

Press ⌘ ⇧ K.
Start typing Join Session and select the corresponding action when it appears in the suggestions.
Specify the workspace ID or URL and press ⏎.
Wait until the connection is set up.

Connecting with SSH

You can establish an SSH connection to a remote machine, run the JetBrains Fleet backend on it, and work on your project remotely.

Creating an SSH connection

To create an SSH connection, choose one of the following methods:
- Open Tools and select Actions. On the Actions tab, type SSH and select Connect to SSH.
- Click Workspaces and navigate to Connect to | SSH.
Enter connection details in the following fields:
- Host: enter the IP address of the machine where you plan to install and run JetBrains Fleet or where JetBrains Fleet is already running.
- Port: specify the port of the machine you wish to connect to.
- User: enter the name of your user.
- Private key file: enter the path to your private SSH key file.
Click Connect.
Upon connecting, JetBrains Fleet uploads its backend to the host machine and initiates it there. If the backend is already installed, JetBrains Fleet will start it.

JetBrains Fleet supports direct connections to SSH using a URI handler. This allows you to connect to remote hosts from the command line using a streamlined URI format.

The URI format for connecting to SSH with JetBrains Fleet is:

://.ssh/<hostname>?<query_params>

On macOS, the format is the following:

open "://.ssh/<hostname>?<query_params>"

For more information about connecting to SSH with a URI handler, refer to Connecting to SSH with JetBrains Fleet URI handler.

09 August 2024