Skip to content

posit-dev/jupyter-positron-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 and signing key

Configuration

Setup includes installing a proxy for running Positron and a verifier service to check license validity. The setup flow looks like:

  1. Email academic-licenses@posit.co to request a signing key (signing-key.pem) and license file (license.lic). Free for currently enrolled students using Positron for coursework — see the Positron Education License Rider for eligibility.
  2. Download the Positron Server binary and extract it to /opt/positron-server in the single-user image, then place license.lic at resources/activation/linux/<arch>/license.lic (chmod 600, root-only).
  3. Install jupyter-positron-server in the single-user image.
  4. Install jupyter-positron-verifier in the Hub's Python environment, and store signing-key.pem at /etc/positron/signing-key.pem (root-only).
  5. Register jupyter-positron-verifier as a JupyterHub service in jupyterhub_config.py, and point c.Spawner.environment at its minting endpoint.
  6. Restart JupyterHub, then click the "Positron" icon in the JupyterLab launcher.

See the Get Started guide for the full walkthrough, including the exact jupyterhub_config.py snippets.

About

Python package for running a Positron Server proxy in Jupyter

Resources

License

Stars

4 stars

Watchers

2 watching

Forks

Contributors

Languages