Installing Polynote


Polynote is a web-based programming notebook tool. Like other notebook tools, a large part of its usefulness relies on arbitrary remote code execution.

It currently contains no built-in security or authentication of its own, and relies entirely on the user deploying and configuring it in a secure way.

Polynote should only be deployed on a secure server which has its own security and authentication mechanisms which prevent all unauthorized network access.

You are solely responsible for any damage or other loss that occurs as a result of running Polynote.


Polynote consists of a JVM-based server application, which serves a web-based client. To try it locally, find the latest release on the releases page and download the attached polynote-dist.tar.gz file (you’ll find it under Assets). Unpack the archive:

tar -zxvpf polynote-dist.tar.gz
cd polynote



To change any of the default configuration, you’ll need to copy the included config-template.yml file to config.yml, and uncomment the sections you’d like to change. Check out the template itself for more information.


To start the server, run the included python script:



Once the server has started, navigate your browser to http://localhost:8192 (if using the default network configuration). Next, read about basic usage