# Connect to a remote server from GoLand

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/go/llms.txt).

> **TL;DR**
> Make sure the [prerequisites](prerequisites.html) are met.

Since working remotely became a necessity, GoLand offers the Remote Development functionality to help you code, run, debug, and deploy your projects remotely.

## Connection via SSH

The connection to a remote server is done by using SSH and can be started right from the GoLand home screen.

![GoLand welcome screen](https://resources.jetbrains.com/help/img/idea/2026.3/go_remote_development_from_start_screen.png)

Procedure: Connect to a remote server and open the remote project

1. Ensure you have the bundled JetBrains OS integration and Remote development plugins enabled.

2. On the GoLand Home screen, click  Connect to Remote. Alternatively, go to `File | Connect to Remote` in the main menu.

3. In the Connect to Remote window, click the SSH  tab.

![Connect to Remote](https://resources.jetbrains.com/help/img/idea/2026.3/connect_ssh.png)

If you have the IDE already running on the remote server, and you have a [connection link](remote-development-a.html#use_idea), you can click Link and add the actual link to the field under the Connect to Running IDE section.

4. Click the drop-down to see connections from the recent history, the Toolbox App, OpenSSH, and the IDE settings.

![Recent Connections](https://resources.jetbrains.com/help/img/idea/2026.3/recent_connections.png)

If you do not have any recent configurations, from the drop-down, select SSH Configuration to open the [SSH Configuration](settings-tools-ssh-configurations.html) settings.

5. Configure the remote server connection parameters, click Test Connection to ensure the connection to the remote server is successful, and click OK to save the changes.

6. After the remote server configuration, add the SSH connection and click Connect.

7. Specify a project directory and click Open Project to start working on the project right away in Light Mode while the backend IDE is being configured.

![Open remote project](https://resources.jetbrains.com/help/img/idea/2026.3/select_project_for_remote.png)

Alternatively, click Skip and Open IDE to finish the backend configuration first and then open your project.

If you need to switch to other SSH connection, click the Change button to return to the previous page of the wizard.

For the information on how to start working with a separate JetBrains Gateway installer, refer to [JetBrains Gateway](remote-development-a.html#gateway).

For more information about adding plugins or SDK, refer to the appropriate [Getting Started](work-inside-remote-project.html#plugins) section.

## Connect to a project running on WSL2

> **Note:**
> By default, projects in WSL2 will open locally without the Remote Development workflow. To switch back, disable the Open WSL projects natively as local projects (without Remote Development) option in the [Gateway WSL](advanced-settings.html#gateway_wsl).
>
>
>
> For the information on how to launch projects in WSL, refer to [WSL](how-to-use-wsl-development-environment-in-product.html).

You can configure your IDE backend to launch directly in WSL2.

Before you start connecting to WSL, check the [system requirements for remote development](prerequisites.html) and make sure the additional ones are met:

* You have a WSL 2 distribution that meets the [Linux requirements for GoLand](installation-guide.html#requirements).

* You have WSL2 configured on your Windows machine. For more information, refer to the [WSL2 configuration](https://www.jetbrains.com/help/idea/how-to-use-wsl-development-environment-in-product.html#wsl-general) section.

Procedure: Connect to WSL

1. [Install and run](installation-guide.html) GoLand locally on Windows as you normally would.

2. On the GoLand Home screen, click  Connect to Remote. Alternatively, go to `File | Connect to Remote` in the main menu.

3. In the Connect to Remote window, click the WSL tab.

![WSL tab](https://resources.jetbrains.com/help/img/idea/2026.3/wsl_start_page.png)

Click New Project to create the new project in the WSL system.

4. On the Choose WSL Instance page, in the Location field specify a directory where your project will reside.

Alternatively, click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg),in the dialog that opens select the location you need and click OK.

![Path to WSL directory](https://resources.jetbrains.com/help/img/idea/2026.3/path_to_wsl_directory.png)

Click Next.

5. On the page that opens, select the following options:

* Name: type the name of your project.

* Create Git repository: select this checkbox if you want to add your project to Git.

* Location: specify the location of your new project on WSL. The syntax of the path to a project is as follows: ``` \\wsl.localhost\DistributionName\home\UserName\ProjectName ``` `DistributionName` is the name of the Linux distribution, `UserName` is the name of your user directory. Check the following example: `\\wsl.localhost\Ubuntu\home\test\MyProject`.

* Build system: specify a build tool for your project.

* JDK: specify your project SDK located on WSL.

* Add sample code: select this option for GoLand to add a simple, runnable code to your project.

* Advanced settings: depending on your project, the settings contain additional options.

![New Project: project sdk](https://resources.jetbrains.com/help/img/idea/2026.3/new_project_wsl.png)

6. Click the Browse button and navigate to the directory in WSL where you want to create a new project.

In the Select Base Directory dialog, you can click the New Folder button (![the New Folder icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.newFolder.svg)) to create a folder for a project.

The project location for WSL will show the absolute path starting with `\\wsl$` to the WSL file system.

7. Click Create.

GoLand creates a project located in WSL, and you can develop and build your project inside the WSL environment without leaving the IDE.

![create project folder in wsl](https://resources.jetbrains.com/help/img/idea/2026.3/go_create_project_folder_in_wsl.png)

[JetBrains Gateway](remote-development-a.html#gateway) is used as an entry point to connect to a remote server via SSH. It launches [JetBrains Client](work-inside-remote-project.html#work_with_remote), which is a thin client that enables you to work with your remote project.

You can use one of the following ways to launch JetBrains Gateway:

Use the bundled plugin, install Gateway with the Toolbox App, or download the standalone launcher. For instructions, refer to [Install JetBrains Gateway](jetbrains-gateway.html).

