PhpStorm 2021.1 Help

Run PhpStorm for the first time

You can use the Toolbox App to run any JetBrains product. In case of a standalone installation, running PhpStorm depends on the operating system:

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.

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

Run the shell script in the installation directory under bin. You can also use the desktop shortcut, if it was created during installation.

For information about running PhpStorm from the command line, see Command-line interface.

When you run PhpStorm for the first time, some steps are required to complete the installation, customize your instance, and start working with the IDE.

Select the user interface theme

Select whether you want to use the default Darcula or Light theme.

Select the UI theme

For more information, see User interface themes.

Create launcher script

Create Launcher Script

For the Linux and macOS users, PhpStorm suggests the ability to use command line to open projects and separate files by specifying the directory or filename:

  • Select the Create a script for opening files and projects from the command line checkbox, and specify the name of the command-line launcher script to be created.

  • If necessary, you can create a command-line launcher later by using the Tools | Create Command-line Launcher command on the PhpStorm main menu.

Windows users can complete the dialog, since there is no need to specify a command-line tool. Later, for opening a file or project from command line, it will be enough to launch the .exe file with the project or filename as a command-line argument.

Download and install additional plugins

If necessary, click Plugins in the left-hand pane and download and install additional plugins from the PhpStorm plugins repository.

Install additional plugins

Start a project in PhpStorm

When you click Start using PhpStorm, it will show the Welcome screen.


In the Welcome to PhpStorm dialog, you can do the following:

  • Create a new project

  • Open a project

  • Get a project from a version control system

Last modified: 26 August 2021