PhpStorm 2026.3 Help

Connect to a remote server from PhpStorm

Since working remotely became a necessity, PhpStorm offers the Remote Development functionality to help you code, run, debug, and deploy your projects remotely.

Connection via SSH

The connection to a remote server is done via SSH and can be started right from the PhpStorm home screen.

PhpStorm welcome screen

Connect to a remote server and open the remote project

  1. Ensure you have the bundled JetBrains OS integration and Remote development plugins enabled.

  2. On the PhpStorm Home screen, click Connect to Remote. Alternatively, go to File | Connect to Remote in the main menu.

  3. In the Connect to Remote window, click the SSH tab.

    If you have the IDE already running on the remote server, and you have a connection link, you can click Link and add the actual link to the field under the Connect to Running IDE section.

  4. If you do not have any recent configurations, from the drop-down, select SSH Configuration to open the SSH Configuration settings.

  5. Configure the remote server connection parameters, click Test Connection to ensure the connection to the remote server is successful, and click OK to save the changes.

  6. After the remote server configuration, add the SSH connection and click Connect.

  7. Specify a project directory and click Open Project or Skip and Open IDE.

For the information on how to start working with a separate JetBrains Gateway installer, refer to JetBrains Gateway.

For more information about adding plugins or SDK, refer to the appropriate Getting Started section.

Connect to a project running on WSL2

You can configure your IDE backend to launch directly in WSL2.

Before you start connecting to WSL, check the existing prerequisites and make sure the additional ones are met:

  • You have the Windows 10 or 11 version installed on your machine with the Ubuntu 20.04 version installed under WSL2.

  • You have WSL2 configured on your Windows machine. For more information, refer to the WSL2 configuration section.

Connect to WSL

  1. Ensure you have the Remote Development Gateway plugin enabled.

  2. On the PhpStorm Welcome screen, select Remote Development.

  3. Under Remote Development, select WSL.

  4. Click New Project | Connect to Host.

    New Connection
  5. On the next page, select the WSL instance and click Next.

    Choose WSL instance
  6. On the next page, select the IDE version and the project you want open. Click Start IDE and Connect.

    Choose the IDE version and a project

    The connection is established, the backend IDE is downloaded, and the project is opened in JetBrains Client.

04 November 2026