# Run SSH terminal

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

> **TL;DR**
> Add SSH configurations: `Settings | Tools | SSH Configurations`
>
>
>
> Start an SSH session from the main menu: `Tools | Start SSH Session`
>
>
>
> Configure SSH terminal: `Settings | Tools | 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](creating-a-remote-server-configuration.html).

Procedure: 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](create-ssh-configurations.html) 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` (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))), 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](vagrant-support.html).

* 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](create-ssh-configurations.html). * 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](settings-tools-ssh-configurations.html) 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.

Procedure: 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`.

Procedure: View SSH logs

To troubleshoot an SSH connection, check the [IDE logs](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#logs-directory). 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.

## See also

### Procedures

[Deployment](deploying-applications.html)

### Reference

[SSH Terminal](settings-tools-ssh-terminal.html) [Deployment](settings-deployment.html)

