Installing and launching GoLand
2 GB RAM minimum, 4 GB RAM recommended
1.5 GB hard disk space + at least 1 GB for caches
1024x768 minimum screen resolution
JRE 1.8 is bundled with the GoLand distribution. You do not need to install Java on your computer to run GoLand.
32-bit or 64-bit versions of Microsoft Windows 10, 8, 7 (SP1), or Vista (SP2)
macOS 10.8.3 or later
Download and install GoLand
To install GoLand
Download GoLand for your operating system.
- Do the following depending on your operating system:
- Windows installation:
*.exefile you've downloaded.
GoLand-*.exefile you've downloaded.
Follow the instructions in the installation wizard.
- macOS installation:
.dmgpackage that you've downloaded, and drag GoLand to the Applications folder.
GoLand-*.dmgpackage that you've downloaded, and drag GoLand to the Applications folder.
- Linux installation:
- Unpack the
goland-2017.3.tar.gzfile you have downloaded to a different folder if your current Downloads folder doesn't support file execution:
tar xfz goland-2017.3.tar.gz <new_archive_folder>
The recommended installation location according to the filesystem hierarchy standard (FHS) is
/opt. To install GoLand into this directory, enter the following command:
sudo tar xfz goland-2017.3.tar.gz -C /opt/
Switch to the
cd <new archive folder>/goland-2017.3/bin
- Unpack the
- Windows installation:
Manage GoLand through Toolbox App
Toolbox App is a control panel that allows you to manage all JetBrains developer tools, including GoLand, as well as your projects, from a single point of access. It lets you launch the IDEs, maintain different versions of the same tool, install updates and roll them back if needed. It also remembers your JetBrains Account and uses it to automatically log you in when you install and register new tools.
Launch the setup file.
Now you can manage existing tools, install new tools, and download updates:
Run GoLand for the first time
Import GoLand settings
When you start GoLand for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings.
If this is your first instance of GoLand, choose the Do not import settings option.
Create a workspace and start a project in GoLand
After you have completed the initial GoLand configuration, the Welcome screen appears.
Set up a workspace
Before you start creating or importing your GoLand project, make sure you have done the following:
Created a workspace where you keep projects.
Use the following layout:
Downloaded Go distribution.
Defined the environment variable GOPATH that points to the workspace location. This variable will be used by Go commands and the IDE to resolve import statements, install, build and update packages, etc.
Create a new project
Click Create New Project on the Welcome screen.
If the workspace is set up then GoLand will suggest you to create a project in the
srcsubdirectory. Specify the name of your project in the Location field, the Go SDK (GOROOT) and click Create. GoLand creates a project in the workspace and the appropriate Go settings.
Open an existing project
On the Welcome screen click Open and select the project directory. If your project is not inside the created workspace, move the project into your workspace first.
When you open your project GoLand automatically tries to locate SDK (GOROOT). If GoLand cannot find GOROOT, the appropriate message with a link will appear suggesting to configure the Go SDK.
Click the suggested link and specify the location of the Go distribution. After you set SDK, wait until GoLand finishes indexing the workspace.
Attach a directory to an already-opened project
You can attach a directory to an already-opened project. For example, when you need to open several projects in a single GoLand instance as you want.
Navigate to the folder with the project that you want to attach.
In the Open Project dialog, click Attach.
Detach the attached directory
In settings (Ctrl+Alt+S), navigate to Remove Content Entry icon ().. In the pane with the project structure, click the
You can quickly create and run a Go application.
In the Project tool window, right-click the project.
From the context menu, select.
In the dialog that opens, specify the name of your application and select Simple Application from the Kind drop-down list.
GoLand creates an executable application.
In the editor add code and click the icon in the left gutter or press Ctrl+Shift+F10 to run the application. The result is displayed in the Run tool window.
Run a program
To run a Go code, you need to adjust your run configuration or create a new one. You can manage your run configurations in the Run/Debug Configurations dialog.
On the main menu, select.
In the Run/Debug Configurations dialog, click and from the list that opens, select the appropriate configuration.
The Go Build type is equal to go build command.
The Go Test type is equal to go test. Make sure to select the test framework your tests use: gotest, gocheck or gobench.
The Go App Engine type lets you run Go App Engine applications. Note, it requires your Go module to use a Go AppEngine SDK.
Specify the run configuration options. You can also specify Before Launch options, for example, you can add a Go command that you want to run before executing the created configuration. Click OK.
On the main menu, selector press Ctrl+Shift+F10.
Change the GOPATH or the GOROOT settings
Press Ctrl+Alt+S to open the Settings/Preferences dialog.
From the options on the left, click GO and depending on the settings you want to change, select either GOPATH or GOROOT.
On the GOROOT settings page, you can change the GOROOT location or specify a new version of the downloaded Go SDK.
On the GOPATH settings page, you can change GOPATH global and project-level settings. If you'd like to use a GOPATH different from the one specified in the environment variable, clear the option Use GOPATH that's defined in system environment and specify the one you want.
To try and evaluate GoLand, you can download and install its trial version for free. The trial version is available for 30 days, whereupon you need to obtain and register a license.
Do one of the following:
On the Welcome screen, click Configure | Manage License
On the main menu, select Help | Register
Select how you want to register GoLand:
Register using the JetBrains Account.
For more information, see What is JetBrains Account?
Register using an activation code.
Register using a License Server.
To override the URL of the system proxy during initial GoLand startup, use the
-Djba.http.proxyproperty, which can be added as a JVM option.
When performing silent install or managing GoLand installations on multiple machines, you can set the
JETBRAINS_LICENSE_SERVERenvironment variable to point the installation to the license server URL.
If you have plugins that require a license, then instead of the License Activation dialog, open the Licenses dialog by clicking from the main menu.
The Licenses dialog contains a list of licenses and shows their states:
Expired: Renew your license to continue.
Grace period: You have several days until the license expires.
Evaluation period: Use without an active license.
Active license: Use until the expiry date.
To configure a license, click the Edit button, which opens the License Activation dialog.
Location of GoLand settings, plugins, and logs directories
After you have installed GoLand, its default location depends on your operating system.
Windows Vista, 7, 8, 10
Linux and other Unix systems
GoLand directory starting with dot is located in your user home directory:
Mac OS X
Each created subdirectory has its own location:
If you want to override the default settings, refer to the support article.
Install GoLand as a snap package on Linux
You can install GoLand on Linux as a self-contained snap package. Since snaps update automatically, your GoLand installation will always be up-to-date.
GoLand is distributed via two channels:
The stable channel includes only stable versions. To install the latest stable release of GoLand, run the following command:
$ sudo snap install goland --classic
The edge channel includes EAP builds. To install the latest EAP build of GoLand, run the following command:
$ sudo snap install goland --classic --edge
When the snap is installed, you can launch it by running the
To list all installed snaps, run
sudo snap list. For more information, see the Snapcraft documentation.