Skip to content

Getting Started


a) Install Nix

sh <(curl -L --daemon
sh <(curl -L
sh <(curl -L --no-daemon
docker run -it nixos/nix

b) Enable nix command and flakes. See the Wiki.

# ~/.config/nix/nix.conf
experimental-features = nix-command flakes
# /etc/nixos/configuration.nix
{ pkgs, ... }: {
  nix.settings.experimental-features = [ "nix-command" "flakes" ];

Quick Start

The following snippet will create a new project directory, initialize the project with a flake template, enable a Python kernel, and start the JupyterLab environment.

mkdir my-project
cd my-project
nix flake init --template github:tweag/jupyenv
nix run

After some time, you should see the following in your terminal. Your default web browser should open and enter the JupyterLab environment. If it does not, use one of the suggested URLs.

[I 2022-10-11 18:47:30.346 ServerApp] Jupyter Server 1.17.1 is running at:
[I 2022-10-11 18:47:30.346 ServerApp] http://localhost:8888/lab?token=8f2261a45601848bd79eda97d8d39c3d0f4978bc61fbe346
[I 2022-10-11 18:47:30.346 ServerApp]  or
[I 2022-10-11 18:47:30.346 ServerApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 2022-10-11 18:47:30.359 ServerApp]

    To access the server, open this file in a browser:
    Or copy and paste one of these URLs:

For further instructions about the environment, kernels, and extensions, see the How To.