Install PhpStorm - JetBrains

Install PhpStorm

PhpStorm is a cross-platform IDE that provides a consistent experience on Windows, macOS, and Linux.

System requirements

Requirement	Minimum	Recommended
RAM	2 GB of free RAM	8 GB of total system RAM
CPU	Any modern CPU	Multi-core CPU. PhpStorm supports multithreading for different operations and processes making it faster the more CPU cores it can use.
Disk space	3.5 GB	SSD drive with at least 5 GB of free space
Monitor resolution	1024×768	1920×1080
Operating system	Officially released versions of the following: Microsoft Windows 10 1809 64-bit or later Windows Server 2019 64-bit or later macOS 12.0 or later Two latest versions of Ubuntu LTS or Fedora Linux distributions that meet the following requirements: Linux kernel version 6.x Gnome or KDE desktop environment X Window System (X11) Wayland support is in development. You can monitor the progress and leave your feedback in JBR-3206: Native Wayland support. GLIBC 2.28 or later Pre-release versions are not supported.	The latest versions of the following: Windows 64-bit macOS Ubuntu LTS or Fedora Linux distribution

You do not need to install Java to run PhpStorm because JetBrains Runtime is bundled with the IDE (based on JBR 21).

Install using the Toolbox App

The JetBrains Toolbox App is the recommended tool to install JetBrains products. Use it to install and manage different products or several versions of the same product, including Early Access Program (EAP) and Nightly releases, update and roll back when necessary, and easily remove any tool. The Toolbox App maintains a list of all your projects to quickly open any project in the right IDE and version.

Install the Toolbox App

1. Download the installer .exe from the Toolbox App web page.

2. Run the installer and follow the wizard steps.

3. After you run the Toolbox App, click its icon in the notification area and select which product you want to install.

   To install a specific version, click and select Available versions.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

Install the Toolbox App

1. Download the disk image .dmg from the Toolbox App web page.

   There are separate disk images for Intel and Apple Silicon processors.

2. Mount the image and drag the JetBrains Toolbox app to the Applications folder.

3. After you run the Toolbox App, click its icon in the main menu and select which product you want to install.

   To install a specific version, click and select Available versions.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

Install the Toolbox App

For the Toolbox App version 2.6.2 and earlier, the following applies:

The Toolbox App is packaged in AppImage and requires FUSE to run. If your distribution doesn't use the libfuse2 package, install it by running the following command:

sudo apt install libfuse2

• x86_64:

  glibc 2.17 (Ubuntu 18.04 or higher)

• arm64:

  glibc 2.29 (Ubuntu 20.04 or higher)

1. Download the tarball .tar.gz from the Toolbox App web page.

2. Extract the tarball and launch the executable:

   tar -xzf jetbrains-toolbox-<build>.tar.gz && cd jetbrains-toolbox-<build>/bin && ./jetbrains-toolbox

3. The Toolbox App will install itself into $HOME/.local/share/JetBrains/Toolbox/bin and run from there.

   After you run the Toolbox App for the first time, it will automatically add the Toolbox App icon to the main menu.

4. Select the product that you want to install.

   To install a specific version, click and select Available versions.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

If you installed PhpStorm via the Toolbox App, you can find the installation directory in the app: open the settings of the IDE instance in the Toolbox App, expand Configuration, and look for the Install location field.

Standalone installation

Install PhpStorm manually to manage the location of every instance and all the configuration files. For example, if you have a policy that requires specific install locations.

1. Download the installer .exe.

   There is a separate installer for ARM64 processors.

2. Run the installer and follow the wizard steps.

   On the Installation Options step, you can configure the following:

   • Create a desktop shortcut for launching PhpStorm.

   • Add the directory with PhpStorm command-line launchers to the PATH environment variable to be able to run them from any working directory in the Command Prompt.

   • Add the Open Folder as Project action to the system context menu (when you right-click a folder).

   • Associate specific file extensions with PhpStorm to open them with a double click.

     

To run PhpStorm, find it in the Windows Start menu or use the desktop shortcut. You can also run the launcher batch script or executable in the installation directory under bin.

1. Download the disk image.

   There are separate disk images for Intel and Apple Silicon processors.

2. Mount the image and drag the PhpStorm app to the Applications folder.

Run the PhpStorm app from the Applications directory, Launchpad, or Spotlight.

1. Download the tarball .tar.gz.

   There is a separate tarball for ARM64 processors.

2. Extract the tarball to a directory that supports file execution.

   For example, to extract it to the recommended /opt directory, run the following command:

   sudo tar -xzf PhpStorm-*.tar.gz -C /opt

Do not extract the tarball over an existing installation to avoid conflicts. Always extract it to a clean directory.

Execute the ./bin/PhpStorm.sh script from the extracted directory to run PhpStorm.

Create a desktop entry

1. In the main menu, go to Tools | Create Desktop Entry.

   The following steps are for Ubuntu 23.10. If you are using a different Linux distribution or version of Ubuntu, refer to its documentation.

2. Click Activities in the top-left corner of the screen.

3. Click the grid button in the dash to show all applications.

4. To pin the app to the dash, right-click the PhpStorm icon and select Add to Favorites.

When you run PhpStorm for the first time, you can take several steps to complete the installation, customize your instance, and start working with the IDE.

For more information, refer to Run PhpStorm for the first time.

For more information about the location of the default IDE directories with user-specific files, refer to Directories used by the IDE.

Silent installation on Windows

Silent installation is performed without any user interface. It can be used by network administrators to install PhpStorm on a number of machines and avoid interrupting other users.

When performing a silent installation or managing PhpStorm installations on multiple machines, you can set the JETBRAINS_LICENSE_SERVER environment variable to point to the URL of the Floating License Server or License Vault.

Alternatively, you can set the URL of the Floating License Server or License Vault by adding the -DJETBRAINS_LICENSE_SERVER JVM option.

To perform silent install, run the installer with the following switches:

• /S: Enable silent install

• /CONFIG: Specify the path to the silent configuration file

• /D: Specify the path to the installation directory

  This parameter must be the last in the command line, and it should not contain any quotes even if the path contains blank spaces.

• /NCRC: Disable the CRC check if you want to suppress the Verifying Installer popup.

For example:

PhpStorm-*.exe /S /CONFIG=d:\temp\silent.config /D=d:\IDE\PhpStorm

To check for issues during the installation process, add the /LOG switch with the log file path and name between the /S and /D parameters. The installer will generate the specified log file. For example:

PhpStorm-*.exe /S /CONFIG=d:\temp\silent.config /LOG=d:\JetBrains\PhpStorm\install.log /D=d:\IDE\PhpStorm

Silent configuration file

You can download the default silent configuration file for PhpStorm at https://download.jetbrains.com/webide/silent.config

The silent configuration file defines the options for installing PhpStorm. With the default options, silent installation is performed only for the current user: mode=user. If you want to install PhpStorm for all users, change the value of the installation mode option to mode=admin and run the installer as an administrator.

The default silent configuration file is unique for each JetBrains product. You can modify it to enable or disable various installation options as necessary.

It is possible to perform silent installation without the configuration file. In this case, omit the /CONFIG switch and run the installer as an administrator. Without the silent configuration file, the installer will ignore all additional options: it will not create desktop shortcuts, add associations, or update the PATH variable. However, it will still create a shortcut in the Start menu under JetBrains.

Install as a snap package on Linux

PhpStorm installed via snap may encounter issues including performance degradation, problems with JavaScript debugging using Chromium (WEB-38511), difficulties importing SBT projects (SCL-17169), and delays in file management operations (IJPL-1234).

If you experience these issues, we recommend installing PhpStorm via the Toolbox App for a potentially smoother experience.

You can install PhpStorm as a self-contained snap package. Since snaps update automatically, your PhpStorm installation will always be up-to-date.

To use snaps, install and run the snapd service as described in the snapd installation guide.

On Ubuntu 16.04 LTS and later, this service is pre-installed.

PhpStorm is distributed via two channels:

• The stable channel includes only stable versions. To install the latest stable release of PhpStorm, run the following command:

  sudo snap install intellij-idea --classic sudo snap install phpstorm --classic

  The --classic option is required because the PhpStorm snap requires full access to the system, like a traditionally packaged application.

• The edge channel includes EAP builds. To install the latest EAP build of PhpStorm, run the following command:

  sudo snap install intellij-idea --classic --edge sudo snap install phpstorm --classic --edge

When the snap is installed, you can launch it by running the phpstorm command.

To list all installed snaps, run sudo snap list.

Install a specific version

1. To check the list of available versions, run the following command:

   snap info intellij-idea snap info phpstorm

2. To install the version you want, run the following command:

   sudo snap install intellij-idea --channel=2025.3/stable --classic sudo snap install phpstorm --channel=<version>/stable --classic

For more information about other snap commands, refer to the Snapcraft documentation.

16 December 2025Getting startedRun PhpStorm for the first time