jupyter-positron-server 0.0.4

Running the Positron Server Web IDE inside the Jupyter environment

Jupyter Positron Server

Run Positron Server inside your Jupyter environment using jupyter-server-proxy.

Requirements

• Python >= 3.9
• positron-server installed and available in your PATH
• A valid Positron license key file, set as a POSITRON_LICENSE_KEY_FILE environment variable

Installation

pip install jupyter-positron-server

Or install from source:

git clone https://github.com/posit-dev/jupyter-positron-server.git
cd jupyter-positron-server
pip install -e .

Configuration

Download Positron Server

Download the Positron Server binary for your Linux architecture. For the latest release of Positron (April 2026), you can find the downloads here:

• x64: https://cdn.posit.co/positron/releases/server/x86_64/positron-server-linux-x64-2026.04.0-269.tar.gz
• arm64: https://cdn.posit.co/positron/releases/server/arm64/positron-server-linux-arm64-2026.04.0-269.tar.gz

After downloading, untar the archive and add it to your PATH.

If you're using curl, this step might look something like:

# Download Positron server to temporary directory
# Note: this is the url for arm64 architecture machines, 
# x64 machines should use the link provided above
curl -L "https://cdn.posit.co/positron/releases/server/arm64/positron-server-linux-arm64-2026.04.0-269.tar.gz" -o /tmp/positron-server.tar.gz

# Create directory
mkdir -p /opt/positron-server

# Unpack Positron Server into newly created directory
tar -xzf /tmp/positron-server.tar.gz -C /opt/positron-server --strip-components=1

Get a License

Positron Server is available for educational use only. Free licenses are available for currently enrolled students using Positron for coursework. Review the Positron Education License Rider for full eligibility terms.

To request a license, email [e-mail].

Set the License Key

Set the POSITRON_LICENSE_KEY_FILE environment variable to the path of your license key file. If POSITRON_LICENSE_KEY_FILE is unset, Positron will look for a license file at /opt/license.lic, so place your license file there or set the environment variable to the location where your license file actually lives:

export POSITRON_LICENSE_KEY_FILE=/path/to/your/license.lic

Install the jupyter-positron-server package

Install jupyter-positron-server in an environment that is available to all users of your JupyterHub server.

pip install jupyter-positron-server

Start your Jupyter server

1. Start or restart your Jupyter server. In JupyterHub, you can do this by selecting File > Hub Control Panel, then clicking Stop My Server and Start My Server.

2. Click the "Positron" icon in the JupyterLab launcher.