Self-host Open Notebook with Levelrail

Verified

An open source, self-hosted alternative to NotebookLM for researching with your own sources, with podcasts and chat. Add model provider keys in the app after install.

  • AuthorlfnovoVerified by Levelrail
  • LicenceMIT
  • Memory1.5 GiB
  • Archarm64
  • Services2

How to self-host Open Notebook

  1. Pull the images

    2 images are pulled on your server.

    Show images
    • lfnovo/open_notebook:1.15.0
    • surrealdb/surrealdb:v2.6.5
  2. Create the app

    2 services start in a single Compose app, with 2 named volume mounts for your data, on ports 8502, 5055.

  3. Fill in the secrets

    4 secrets are generated and stored encrypted, 6 settings are preset, you do not have to fill in anything.

  4. Open it

    Without a domain the app gets an sslip.io address; add --domain SERVICE=HOST to use your own.

Open Notebook requirements

Memory
About 1.5 GiB
Architectures
amd64 image published, arm64 tested
Ports
8502, 5055
Domain
Optional, an sslip.io address is used without one
Settings
none to fill in
License
MIT, permissive license
  • Verified. Verified on arm64 with image tag 1.15.0. Our CI ran this exact image version and it answered on its health path. Evidence

Install Levelrail first

On a server with Levelrail running, run the command above, or open the dashboard: Apps, New app, Browse templates, then Open Notebook. New to Levelrail? Install it on a fresh VPS first.

docker pull ghcr.io/glincker/levelrail:latest

Then levelrail-cli login --device. See Getting started and the Open Notebook docs page.

Deploy Open Notebook your way

Every format below deploys the same pinned images. Pick the one that fits how you work.

Deploy Open Notebook from the CLI

Add --domain SERVICE=HOST to serve a service on your own domain, for example --domain open_notebook=app.example.com.

levelrail-cli templates install open-notebook --name my-open-notebook

Deploy Open Notebook with the API

Create a token in the dashboard first. Name, env and domains are the request fields.

curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  https://levelrail.example.com/api/v1/service-templates/open-notebook/install \
  -d '{
    "name": "my-open-notebook"
  }'

Open Notebook configuration

Open Notebook services

ServiceImagePortsVolumes
open_notebook lfnovo/open_notebook:1.15.0 8502, 5055 notebook_data -> /app/data
surrealdb surrealdb/surrealdb:v2.6.5 none surreal_data -> /home/nonroot

Open Notebook environment variables

VariableServiceValue
API_URL open_notebook Preset by the template
OPEN_NOTEBOOK_ENCRYPTION_KEY open_notebook Generated at deploy
OPEN_NOTEBOOK_PASSWORD open_notebook Generated at deploy
SURREAL_DATABASE open_notebook Preset by the template
SURREAL_NAMESPACE open_notebook Preset by the template
SURREAL_PASSWORD open_notebook Generated at deploy
SURREAL_URL open_notebook Preset by the template
SURREAL_USER open_notebook Preset by the template
Show all 10 variables
  • SURREAL_PASSsurrealdbGenerated at deploy
  • SURREAL_USERsurrealdbPreset by the template

Ports and volumes

Ports
8502, 5055
Volumes
2 named mounts: notebook_data -> /app/data, surreal_data -> /home/nonroot

Open Notebook FAQ

How much memory does Open Notebook need?

The catalog lists about 1.5 GiB of memory for Open Notebook across its 2 services.

Does Open Notebook run on arm64?

For Open Notebook, arm64 is tested; amd64 is image published.

What licence is Open Notebook under?

Open Notebook is licensed under MIT, which is permissive, with few conditions on reuse.

Does Open Notebook need configuration before it starts?

No. The template fills in its own defaults and generates secrets at deploy time.

Which ports does Open Notebook use?

Open Notebook listens on ports 8502 and 5055 inside the stack.

Where does Open Notebook keep its data?

In named volumes: notebook_data mounted at /app/data and surreal_data mounted at /home/nonroot.

Can I deploy Open Notebook on Dokploy or Dokku?

The services and pinned images on this page can be run on any Docker host. The public Dokploy templates list has an entry with the id open_notebook for this app, so check that entry as well. Dokku deploys container images with its own commands, so the pinned image lfnovo/open_notebook:1.15.0, surrealdb/surrealdb:v2.6.5 is what you deploy there.

levelrail-cli templates install open-notebook --name my-open-notebook