# SSH Configurations

> **TL;DR**
> `File | Settings | Tools | SSH Configurations` for Windows and Linux
>
>
>
> `IntelliJ IDEA | Settings | Tools | SSH Configurations` for macOS
>
>
>
> `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+Alt+S` (NetBeans), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ![the Settings icon](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.settings.svg)

Use this page to [create SSH configurations](create-ssh-configurations.html), which can be used for [configuring remote interpreters](null), [connecting to SFTP deployment servers](creating-a-remote-server-configuration.html), and [launching SSH sessions](running-ssh-terminal.html).

![SSH configurations dialog](https://resources.jetbrains.com.cn/help/img/idea/2026.2/ij_ssh_configuration.png)

|  ![the Add button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.add.svg) Add `Insert` (Windows), `Insert` (macOS), `Insert` (IntelliJ IDEA Classic (macOS)), `Insert` (macOS System Shortcuts), `Insert` (XWin), `Insert` (GNOME), `Insert` (KDE), `Insert` (Emacs), `Insert` (Sublime Text), `Insert` (Sublime Text (macOS)), `Insert` (NetBeans), `Insert` (Visual Studio), `Insert` (Visual Studio (macOS)), `Insert` (Eclipse), `Insert` (Eclipse (macOS))  | Create a new SSH configuration. |
|  ![the Remove button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.remove.svg) Delete `Alt+Delete` (Windows), `Alt+Delete` (macOS), `Alt+Delete` (IntelliJ IDEA Classic (macOS)), `Alt+Delete` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `Alt+Delete` (Sublime Text (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Visual Studio), `Alt+Delete` (Visual Studio (macOS)), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |    Remove the selected SSH configuration.                      > **Note:** > This will affect the [configured remote interpreters](null), [SFTP deployment servers](creating-a-remote-server-configuration.html), and [SSH sessions](running-ssh-terminal.html) that depend on this configuration.    |
|  ![the Copy button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.copy.svg) Copy `Ctrl+D` (Windows), `Ctrl+D` (macOS), `Ctrl+D` (IntelliJ IDEA Classic (macOS)), `Ctrl+D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Ctrl+D` (Emacs), `Ctrl+D` (Sublime Text), `Ctrl+D` (Sublime Text (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Visual Studio), `Ctrl+D` (Visual Studio (macOS)), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  | Create a copy of the selected SSH configuration. |
|  ![the Rename button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.edit.svg) Rename `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R` (NetBeans), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))  | Rename the selected SSH configuration. |

## SSH configuration settings

| Visible only for this project |     Restrict this SSH configuration to the current project. The configuration will not be available in other projects. IntelliJ IDEA stores such configurations in the project's `.idea` directory, which you can share between team members [in a VCS](version-control-integration.html).                            By default, this option is disabled and IntelliJ IDEA stores the SHH configuration in the [IDE configuration directory](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory). In this case, you can use this configuration in any project when working from the current instance of IntelliJ IDEA.     |
| Host |  Specify the hostname of the server to connect to. The default value is `localhost`.  |
| Username | Specify the username for authentication to the server. |
| Port |  Specify the remote port number to connect to. The default value is `22` (the standard TCP port for SSH).  |
| Authentication type |    Select the client authentication method:                            * Password: Authenticate with the specified password and remember it if necessary.    * Key pair: Use [SSH authentication](http://www.ssh.com/) with a key pair (OpenSSH or PuTTY). Specify the location of the private key file and the corresponding authentication passphrase. The public key should be on the remote server. Remember the passphrase if necessary.    * OpenSSH config and authentication agent: Use a credentials helper application that manages your SSH keys, such as [ssh-agent](https://en.wikipedia.org/wiki/Ssh-agent). For example, see the following tutorial: [Generating a new SSH key and adding it to the ssh-agent](https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent).    |
| Parse config file ~/.ssh/config |     Read the [OpenSSH client-side configuration file](https://www.ssh.com/academy/ssh/config) for any options not specified in the SSH configuration for the corresponding host.                            This option is available only for Password and Key pair authentication types. With OpenSSH config and authentication agent, IntelliJ IDEA reads the OpenSSH config file in any case.                           For more information, refer to [Supported OpenSSH directives](create-ssh-configurations.html#openssh-directives), [Run SSH terminal](running-ssh-terminal.html).    |
| Test Connection | Try to connect with the current SSH configuration settings. |

### Connection Parameters

| Send keep-alive messages every |  Send regular packets to keep the SSH connection active. Without regular messages, the remote server might close the connection. Set the message period in seconds.  |
| Strict host key checking |    Specify how to handle new and changed host keys.                                * Yes: Never add new host keys to the user's known_hosts file and never allow connections to hosts with changed host keys.    * Accept New: Always add new host keys to the user's known_hosts file but never allow connections to hosts with changed host keys.    * No: Always add new host keys to the user's known_hosts file and allow connections to hosts with changed host keys.    * Ask: Add new host keys to the user's known_hosts file only after confirmation and never allow connections to hosts with changed host keys. This is the default behavior.    |
| Hash hosts in knownhosts file | Store new host records in hash format. |

## See also

### Procedures

[Create SSH configurations](create-ssh-configurations.html)

