GoLand 2026.3 Help

Run SSH terminal

Use an SSH terminal to run commands on a remote computer from GoLand. For example, you can build or test a Go application using the Go installation on that computer. To transfer project files, configure a deployment server.

Set up the SSH terminal

  1. Make sure the remote computer has an SSH server and that you have an account with access to it.

  2. Create an SSH configuration with the host, port, username, and authentication method required by the server. Test the connection.

  3. Select the remote environment and configure the SSH terminal:

    1. In the Settings dialog (Ctrl+Alt+S) , go to Tools | SSH Terminal.

    2. In the Connection settings area, select the remote environment:

      • Current Vagrant: select this option to have the commands in the SSH Terminal executed on the currently running Vagrant virtual machine.

      • SSH configuration: select this option to have the commands in the SSH Terminal executed on the local or remote Web server accessible through one of the SSH configurations.

        • Select SSH configuration on every run: if this option is selected, you will have to choose the desired configuration from the popup, every time you choose Tools | Start SSH Session from the main menu.

        • If the desired SSH configuration does not appear in the list, click the Set up configurations link, and define one in the SSH Configurations page.

      To use the same SSH connection each time, select an SSH configuration. To choose a connection whenever you start a session, select Select SSH configuration on every run.

    3. From the Default encoding list, select the encoding to use in the SSH terminal.

Launch the SSH terminal

  1. Go to Tools | Start SSH Session…. If prompted, select the SSH configuration for the remote computer.

  2. Run commands in the terminal tab that opens. To end the session, enter exit.

View SSH logs

To troubleshoot an SSH connection, check the IDE logs. For authentication errors, also check the SSH server logs or ask the server administrator. Their location depends on the server operating system and configuration.

For example, on a Fedora server, run sudo journalctl -u sshd.service to view the SSH server logs. These logs can help identify authentication failures and rejected connections.

    28 September 2026