WebStorm 2017.3 Help

Running SSH Terminal

Introduction

You can launch an SSH Session right from WebStorm. By running commands in a dedicated SSH terminal, you can access data on a remote Web server or a Vagrant instance (virtual machine) via an SSH tunnel, mainly upload and download files.

Preparing to work in the SSH Terminal

Make sure, an SSH server is available in the destination environment: a remote Web server or a Vagrant instance (virtual machine).

Register an account on the SSH server in the destination environment and generate a pair of SSH keys or a password, depending on the server policy.

Appoint the destination environment and specify the settings to establish connection with it:

Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or WebStorm | Preferences for macOS, and click SSH Terminal under Tools. The SSH Terminal page opens.

Deployment server: select this option to have the commands in the SSH Terminal executed on the local or remote Web server accessible through one of the server access configurations. From the drop-down list, choose the server access configuration that specifies the destination environment and the settings to establish connection to it.

Select server on every run: if this option is selected, you will have to choose the desired server access configuration from the pop-up window, every time you choose Tools | Start SSH Session on the main menu.

If the option Deployment server has been selected, the SSH Terminal will provide control over the data on the local or remote Web server accessible through the server access configuration selected from the list. For details, see Configuring Synchronization with a Web Server.

If the option Select server on every run has been selected, WebStorm will show a pop-up list to choose the desired server access configuration from.