PhpStorm 2021.3 Help

Getting started with remote development

You can connect to a remote server using the SSH connection to develop, run and deploy your project.

Prerequisites

Before you start developing on the remote machine, make sure you have the following:

  • You have installed a compatible SSH server on the Linux platform.

  • The Linux platform has any recent Linux x86 distribution such as Ubuntu 16.04+, RHEL/Centos 7+, and so on. There is no arm64 support yet. We recommend that you use Remote Development on machines with 2+ cores, 4GB+ of RAM, and 5GB+ of disk space.

  • You need to have the sftp subsystem enabled on the remote server. In the current implementation, we use it for the backend deployment.

JetBrains Gateway

JetBrains Gateway is a lightweight launcher that connects a remote server with your local machine, downloads necessary components on the backend, and opens your project in JetBrains Client.

You can use JetBrains Gateway as a standalone launcher or as an entry point from your IDE to connect to a remote server.

Launch JetBrains Gateway and connect to a remote server

  1. Download and install the JetBrains Gateway launcher.

    Alternatively, you can access JetBrains Gateway from the welcome screen of your IDE through the Remote Development option.

  2. In the Remote Development wizard, click Connect via SSH.

    JetBrains Gateway
  3. On the next page of the wizard, specify the SSH configuration through which you want to connect to a remote server.

    Connect via SSH

    Alternatively, click SSH configurations to open the SSH Configurations dialog and configure the SSH settings.

    In the SSH Configurations dialog, add the following information:

    SSH configurations
    • Host: specify the address of your remote server.

    • Port: specify the SSH port, which defaults to 22.

    • Local port: specify the outgoing port.

      For example, TCP 10.101.0.1:50705->13.49.137.87:22 (ESTABLISHED).

    • User name: specify the name of a user on a remote server.

    • Authentication type: select one of the following authentication methods:

      • Password: to access the host with a password. To save the password in PhpStorm, select the Save password checkbox.

      • Key pair (OpenSSH or PuTTY): to use SSH authentication with a key pair. To apply this authentication method, you must have a private key on the client machine and a public key on the remote server. PhpStorm supports private keys that are generated with the OpenSSH utility.

        Specify the path to the file where your private key is stored and type the passphrase (if any) in the corresponding fields. To have PhpStorm remember the passphrase, select the Save passphrase checkbox.

      • Parse config file ~/.ssh/config: select this option if you want JetBrains Gateway to use the .ssh/config file.

    • Test Connection: click this button to see whether the connection is established.

    • Connection Parameters: use this section to configure additional parameters for the connection.

    • HTTP/SOCKS Proxy: use this section to configure proxy settings. For more information, refer to Proxy settings.

    Click OK to save the changes and return to the Welcome to JetBrains Gateway dialog.

    Click Check Connection and Continue to check whether the connection is established.

  4. On the next page, specify the PhpStorm version to download to the remote server. JetBrains Gateway displays a list of the IDEs versions that are available for downloading and the already installed ones. The versions on JetBrains Client and the remote host must be the same.

    the IDE version

    Add the path to your project on the remote host.

    Path to remote project

    Click Download and Start IDE.

    JetBrains Gateway downloads the IDE, and opens your remote project in JetBrains Client. The connection is shown in the JetBrains Gateway window, from which you can connect to other IDEs or disable the connection. This window is hidden to tray by default.

    Gateway window

Open recent projects

  1. In the JetBrains Gateway wizard, select SSH from the options on the left.

  2. In the search field enter the name of your project to quickly navigate to it.

    Recent projects

    If you need to quickly access the terminal, click Open terminal.

Stop the running instance

  1. In the JetBrains Gateway wizard, select SSH from the options on the left.

  2. When your remote session is active, the Running indicator is displayed against the project.

    Recent projects

    Click Platform impl actions more against the project and select Stop Instance to stop the remote session for the project in question.

    Recent projects

    You can also select Remove from Recent Projects to remove the project listed on the page altogether.

Connect to a remote project from the local IDE

If you have PhpStorm installed on your remote server, you can quickly connect to your remote project from the local IDE. It works the same as from JetBrains Gateway.

Connect from the local IDE

  1. Make sure you have downloaded and installed JetBrains Gateway on your local machine.

  2. Make sure you have an SSH connection and the PhpStorm IDE on the remote host.

  3. In the terminal, run the following command:

    remote-dev-server.sh run <path/to/project> --ssh-link-host <host>

    For example,

    ~/.cache/JetBrains/RemoteDev/dist/f8a03266ddbb1_PhpStorm-213.5744.147/bin/remote-dev-server.sh run ~/PhpstormProjects/phpstorm-workshop/ --ssh-link-host ec2-13-50-136-85.eu-north-1.compute.amazonaws.com

    The remote-dev-server.sh script, along with the downloaded IDE and the IDE logs are located in the bin directory on the remote server. To locate it, you can run the following command:

    find ~ -iname 'remote-dev-server.sh'

    which will output the path to the remote-dev-server.sh script:

    /home/ubuntu/.cache/JetBrains/RemoteDev/dist/247c8fb97bb32_PhpStorm-213.5281.20/bin/remote-dev-server.sh
  4. As an output, you should receive the following link:

    Http link: https://code-with-me...

  5. Copy the generated link and paste it into your local browser.

  6. In the dialog that opens, click Open JetBrains Gateway.

    Open JetBrains Gateway dialog

    The JetBrains Gateway welcome screen opens.

  7. In the Connect to Remote Host with a Link section, enter the same generated link to start a remote session.

  8. Click Connect. PhpStorm opens the remote project in JetBrains Client.

Install plugins

You can install plugins that you need on the remote server. Note that plugins are installed per project. Each time you create a remote connection for a new project, you need to install a plugin that you need.

Based on the scenario that you use for downloading PhpStorm on the remote server, you either install the plugin via the command line or use the UI of a remote project for your installation.

Install a plugin via the command line

If you manually configure PhpStorm on the remote server, use the following steps to add plugins:

  1. From the JetBrains Marketplace page, find a page of the required plugin, select "Versions" tab, click any version to copy pluginId (short name such as NodeJS) of the plugin you want to install.

  2. Open of the remote server and add the following command:

    bin/remote-dev-server.sh installPlugins PROJECT_PATH pluginId

    (where PROJECT_PATH is a path to your remote project and pluginId is an ID you got from the JetBrains Marketplace page.)

  3. Continue with launching JetBrains Gateway and opening the remote project with the remotely installed plugin.

Install a plugin via UI

If you use JetBrains Gateway to download PhpStorm to a remote server, use the following steps to install plugins.

  1. Open a remote project in JetBrains Client.

  2. Press Ctrl+Alt+S to open the IDE settings and select Plugins On Host.

  3. Download the needed plugin the same way as you would in a regular PhpStorm project.

    The Plugins settings dialog

    For more information on regular plugin installation, refer to Install plugins.

  4. After you download and enable the plugin, click OK to save the changes.

    The plugin is installed remotely. However, keep in mind that the plugin is installed per project.

Alternatively, on the main toolbar, click the Cogwheel icon and select Plugins. In this case the remote Plugins settings page will be opened.

Work inside the remote project

A remote project gets opened in JetBrains Client as it would be opened in your local PhpStorm IDE. You can develop it like any other local project: edit code, run applications, debug, and deploy.

If you want to find more about the Remote Development processes and architecture in general, refer to Remote development overview.

Add VM options

You can adjust VM options for the remote project, especially if you want to increase the -Xmx memory size when working with a larger project. You need to perform those actions and save your changes on the remote server.

  1. In the command line, run the following command:

    $IDE_BIN_DIR/${IDE_PRODUCT_VM_OPTIONS}.vmoptions

    Check the following example:

    ./.cache/JetBrains/RemoteDev/dist/a17ad99f7faf8_ideaIU-2021.3.1/bin/idea64.vmoptions
  2. Edit the phpstorm64.vmoptions file.

    For example, change the -Xmx2048 option to -Xmx3072.

    For more detailed information on VM options, refer to Advanced configuration.

  3. Save the changes and restart your IDE on the remote server. Your changes will appear in your remote project.

Access the backend IDE UI

If you encounter a problem working in JetBrains Client, you can open a main tool window of the backend IDE and try to fix your problem there.

  1. On the main toolbar, click More options next to IDE Backend.

  2. Select Show Main Window.

    Show main tool window

    The main window of the backend IDE gets projected. Now you can use it to access remote settings and configure various remote options if you couldn't do that in JetBrains Client.

Close the Remote Development session

  • Click the Close button to close the remote session window.

    You are returned to the JetBrains Gateway welcome screen where you can use the Recent SSH projects page to reconnect to your remote session or stop the running instance.

Create multiple connections

You can create multiple connections to the same remote host and the same version of the IDE. You can also have connections with different IDE versions and remote hosts.

  1. Connect and open a remote session.

  2. Since JetBrains Gateway is constantly active once you have connected to the remote server, you can click its icon to open the JetBrains Gateway welcome screen and configure other connections.

    If you connect to the same IDE version, then JetBrains Client will be opened as an instance of the same process. If you connect to a different remote host or IDE version, a different remote session will be launched.

Last modified: 19 March 2022