PyCharm 2024.2 Help

Manage Jupyter notebook servers

In PyCharm, you can execute code cells using:

  • Managed server – a Jupyter server that is automatically launched by PyCharm for the current project. It will be terminated when you close PyCharm.

  • Configured server – any Jupyter server that you connect to by specifying its URL and token.

Launch a local Jupyter server

  • To run a Jupyter server just execute any code cell. When you initiate cell execution, PyCharm launches a Jupyter server on the local host using any available port (by default, it is the 8888 port). You can switch to the Jupyter Server tool window to preview the server's configuration details.

Jupyter server is running. Jupyter tool window

Once the server is launched, it is shown as a managed server in the list of the servers in the Jupyter toolbar. You can also see the automatically created server kernel in the list of kernels. This kernel is based on the Python interpreter configured for the project.

Jupyter notebook toolbar; Managed server is connected

Connect to a Jupyter server

  1. Go to Tools | Add Jupyter Connection.

  2. In the New Jupyter Connection dialog, select the connection type:

    • Start a local Jupyter server: run a Jupyter server in a local directory that will be attached to your workspace.

    • Connect to Jupyter server using URL: establish a connection to a remote Jupyter server. The target URL should contain a server name or its address and the access token.

    Add a remote connection to a Jupyter server

    Once the connection has been established, the server and its structure are shown in the Project tool window.

Stop the Jupyter server

  • To stop any running server, switch to the Jupyter Server tool window and click the the Stop button icon. Preview the status in the Server Log window.

Stopping the server

Once you have shut down the server, the current session is terminated. When you start the server next time using the Run server icon icon, execution results for all previous sessions and all notebooks will be lost.

Restart the kernel

  • You might want to refresh your calculations without shutting down the entire server and affecting any other notebooks. To restart the currently running kernel, click Kernels on the Jupyter notebook toolbar. You can then view the kernel status in the Server Log window:

    Restarting the current kernel

You can execute your notebook code cells on a specific Jupyter server.

When you launch any managed server, by default it uses the current Python interpreter and the automatically selected port. However, you can select any other available interpreter and specify an alternative port. You can also connect to any configured server if you know its URL and token.

Configure a Jupyter server

  1. Select Configure Jupyter Server from the list of the Jupyter servers in the Jupyter notebook toolbar.

    Configure a Jupyter server
  2. Select Use Managed Server. By default, the server uses the current Python interpreter. If necessary, you can select any other available interpreter from the list.

    Select an interpreter for the managed server
  3. Set the server settings using the Command line arguments field.

  4. Set Environment variables and assign values to them.

    Create environment variables and assign values
  5. Click OK to apply the changes and close the dialog, or click Apply to keep the dialog open.

  6. Execute any code cell to run the managed server.

Connect to a configured Jupyter server

  1. Select Configure Jupyter Server from the list of the Jupyter servers on the Jupyter notebook toolbar.

    Configure a Jupyter server
  2. Select Configured Server and specify the server's path. It should contain the server's name or its address, and the access token.

    Configure a Jupyter server. Settings dialog
  3. Click OK to apply the changes and close the dialog, or click Apply to keep the dialog open.

  4. Once the connection has been established, the server and its structure are shown in the Workspace tool window.

Last modified: 11 October 2024