# Installing and configuring GoLand

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

Install GoLand using the JetBrains Toolbox App, then configure the Go SDK, a keymap, and any plugins you need. For other installation methods, refer to the [installation guide](installation-guide.html#standalone).

## Install using the Toolbox App

The [JetBrains Toolbox App](https://www.jetbrains.com/toolbox/app/) is the recommended tool to install JetBrains products. Use it to install and manage different products or several versions of the same product, including [Early Access Program](https://www.jetbrains.com/community/eap/) (EAP) and Nightly releases, update and roll back when necessary, and remove any tool. The Toolbox App maintains a list of all your projects to quickly open any project in the right IDE and version.

For more information about Nightly builds, refer to [What are nightly builds? in the FAQ section.](faq-about-goland.html#what-are-early-access-program-eap-builds)

> **Warning:**
> Before working with the Toolbox App, ensure that its [system
> requirements](installation-guide.html#requirements) are met.

Windows:

Procedure: Install the Toolbox App

1. Download the installer `.exe` from the [Toolbox App web page](https://www.jetbrains.com/toolbox/app/).

2. Run the installer and follow the wizard steps.

3. After you run the Toolbox App, click its icon ![Toolbox App icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.nodes.toolbox.svg) in the notification area and select which product you want to install.

To install a specific version, click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) and select Available versions.

To install a nightly build, select a version that has `Nightly` in its name.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

macOS:

Procedure: Install the Toolbox App

1. Download the disk image `.dmg` from the [Toolbox App web page](https://www.jetbrains.com/toolbox/app/).

> **Note:**
> There are separate disk images for Intel and Apple Silicon processors.

2. Mount the image and drag the JetBrains Toolbox app to the `Applications` folder.

3. After you run the Toolbox App, click its icon in the main menu and select which product you want to install.

To install a specific version, click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) and select Available versions.

To install a nightly build, select a version that has `Nightly` in its name.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

Linux:

Procedure: Install the Toolbox App

The following packages must be present:

`libxi6` `libxrender1` `libxtst6` `mesa-utils` `libfontconfig` `libgtk-3-bin` `tar` `dbus-user-session`, `libxcb-keysyms1`.

1. [Download the tarball](https://www.jetbrains.com/toolbox/app/) `.tar.gz`.

2. Unpack the downloaded the Toolbox App distribution archive to the location where you want to install the application (`<installation-directory>`):

```SHELL
tar -xvf jetbrains-toolbox-<version>.tar.gz -C <installation-directory>
```

3. To start the application, open a console, navigate to the [installation directory](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html) (`cd` into `<installation-directory>`), and run the following command:

```BASH
./bin/jetbrains-toolbox
```

This will initialize various Toolbox application files in the application directory:

```BASH
~/.local/share/JetBrains/Toolbox
```

Upon the first launch, the Toolbox App will also create a `.desktop` entry file in `~/.local/share/applications`.

4. Select the product that you want to install.

To install a specific version, click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) and select Available versions.

To install a nightly build, select the version that has `Nightly` in its name from the list of versions (for example, 2026.3 Nightly).

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

> **Note:**
> If you installed GoLand via the [Toolbox App](https://www.jetbrains.com/toolbox/app/), you can find the installation directory in the app: open the settings of the IDE instance in the Toolbox App, expand Configuration, and look for the Install location field.

## Setting up your work environment

After installation, you are ready to [open or create a project](#opening_projects), [configure the Go SDK](#configuring-go), and customize the IDE. Customization includes [setting up a preferred keymap](#setting_a_vs_code_keymap) (for example, the VS Code keymap), and [installing plugins](#migration_from_vscode_customize_install_extensions) from the JetBrains Marketplace.

### Opening projects

After you have installed GoLand  and launched it for the first time, you need to create a project. Everything you do in GoLand is done within the context of a project. It serves as a basis for coding assistance, bulk refactoring, coding style consistency, and other features.

You have three options to start working on a project inside the IDE:

* [Open an existing project](#open-project)

* [Check out a project from the Version Control System (VCS)](#checkout-from-vcs)

* [Create a new project](#creating_go_project)

Procedure: Open an existing project

1. On the Welcome to GoLand screen, click Open.

Alternatively, click `File | Open`.

2. In the file browser, navigate to a folder with project files and click Open….

3. Click OK.

![Welcome screen](https://resources.jetbrains.com/help/img/idea/2026.3/go_QST_WelcomeScreen.png)

Procedure: Clone an existing project from a Version Control System

1. On the Welcome screen, click Clone.

2. From the Version Control list, select Git:

To check out files from GitHub, select GitHub and click Log In via GitHub…. You will be redirected to [account.jetbrains.com](https://account.jetbrains.com/) where you need to click Authorize in GitHub. Enter your GitHub credentials and grant access to your GitHub account.

![Authorize in GitHub](https://resources.jetbrains.com/help/img/idea/2026.3/go_authorize_via_github.png)

3. After you have opened your project, you need to specify the location of the Go SDK. You can specify a local path to the SDK or download it. To set the Go SDK, open settings `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) and navigate to `Go GOROOT`. Click the Add SDK button and select between two options:

* Add SDK…: use a local SDK copy. In the file browser, navigate to the SDK version that is on your hard drive.

* Download…: download the SDK. In the Location field, specify the path for the SDK. To use a file browser, click the Browse… icon ![the Browse icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open_dark.svg). Click OK.

For more information about version control systems, refer to [Version control](version-control-integration.html).

![Clone a repository](https://resources.jetbrains.com/help/img/idea/2026.3/go_QST_cloneRepGithub.png)

> **Tip:**
> To use other version control systems, install a corresponding plugin. For more information about installing plugins, read [Extend the IDE with plugins](managing-plugins.html).

Procedure: Create a Go project

1. Select `File | New | Project…`.

Alternatively, navigate to New | Project on the Welcome to GoLand dialog.

2. In the New Project dialog, select Go from the list of available project types.

3. In the GOROOT field, specify the location of your Go installation. GoLand usually detects this location automatically.

To change or install a new Go SDK version, click Add SDK and choose one of the following options:

* Local: to use an existing SDK from your local system.

* Download: to download a Go SDK version from the official repository.

4. (Optional) Select or clear the Enable vendoring support automatically checkbox to enable or disable vendoring support.

5. (Optional) In the Environment field, specify any environment variables your project requires. For example, `GOPROXY`.

To learn more, refer to the [Environment variables section](create-a-project-with-go-modules-integration.html#environment-variables).

> **Note:**
> Do not use this field to set tags for the `GOEXPERIMENT` variable. Instead, use the Experiments field in the Build Tags settings. For details, see [Using Go experiments](configuring-build-constraints-and-vendoring.html#using_go_experiments).

6. Click Create to create the project.

![Integration with Go](https://resources.jetbrains.com/help/img/idea/2026.3/go_general_procedure_of_creating_a_project.png)

### Configuring Go

To build, run, or test a Go project in GoLand, configure the Go SDK. You can use an SDK that is already installed on your computer or download one from GoLand.

Procedure: Configure GOROOT

* Open settings (`Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS))) and navigate to `Go | GOROOT`.

Select a Go version from the list. If none is available, click Add SDK to either [download a Go version](#download-go-sdk) or [select a local Go SDK installation](#navigate-to-go-sdk).

Procedure: Select a local Go SDK

Ensure the selected folder includes both `bin` and `src` directories.

1. Open settings (`Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS))) and go to `Go | GOROOT`.

2. Click the Add SDK button (![the Add SDK button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)), then select Local.

3. In the file browser, navigate to the Go SDK folder on your system.

4. Click Open to confirm.

Procedure: Download the Go SDK

1. Open settings (`Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS))) and navigate to `Go | GOROOT`.

2. Click the Add SDK button (![the Add SDK icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) and select Download….

3. From the list, select the desired Go SDK version.

4. In the Location field, specify where to install the SDK. To browse for a location, click the Browse icon (![the Browse icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open_dark.svg)).

5. Click OK to confirm the download and installation settings.

When you click Apply or OK in the settings dialog, GoLand downloads and unpacks the selected Go SDK automatically.

### Configuring keymap

You can use the default keymap or a keymap for VS Code. You can also download a [PDF reference card](https://resources.jetbrains.com/storage/products/goland/docs/GoLand_ReferenceCard.pdf) for the default keymap.

Procedure: Setting a Visual Studio Code keymap

1. To view the keymap configuration, open the Settings dialog `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) and select Keymap.

2. From the drop-down menu, select VSCode.

### Installing plugins

In GoLand, extensions are called plugins. They function similarly to extensions in VS Code, enabling you to enhance the built-in features and customize your IDE.

Procedure: Install a plugin from Marketplace

1. [Open settings](jetbrains://tool/settings?name=Plugins) or press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) in your IDE and then select `Plugins`.

2. Type the name of the plugin you want to install in the search field.

Click ![](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.general.sortBy.png) Show Marketplace results in the search field to see options sorting search results. Click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.filter.svg) Filter plugins to see the available filtering options.

3. To install the plugin, click Install and restart the IDE if prompted.

To install a specific version, go to the plugin page in [JetBrains Marketplace](https://plugins.jetbrains.com/), download and install it as described in [Install plugin from disk](managing-plugins.html#install_plugin_from_disk). For example, you can do it if the most recent version of the plugin is broken.

For more information about plugins, refer to [Extend the IDE with plugins](managing-plugins.html).

