selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

open-notebook logo

Self-host open-notebook

v1.15.1

Notebook LM alternative with podcasts and multi-model AI

ReleaseOpen SourceMIT
Docker ComposeCompose file & guide
docker compose up -d
Updatedlast week
LanguageTypescript
Setup difficultyEasy
Stars
42 025
Ports
8502 (Web UI), 5055 (REST API (also served under /api, with Swagger UI at /docs))
Docker
lfnovo/open_notebook
open-notebook screenshot 1

What is open-notebook?

open-notebook alternatives

All self-hosted alternatives to Google Notebook LM → All self-hosted alternatives to NotebookLM →

Should you self-host open-notebook?

open-notebook scores 81/100 on selfhost.directory (how scoring works) and ranks #4 of 42 in Knowledge Management. It has 42 025 GitHub stars, +1 868 in the last 30 days.

It shipped 17 stable releases in the past year. The latest, v1.15.1, came out on 4 November 2026. New versions land roughly every 10 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is surfsense (71/100, 16 890 stars). open-notebook scores higher overall. See open-notebook vs surfsense side by side.

Features

  • Chat with document context
  • Citations in AI answers
  • Custom content transformations
  • Fine-grained AI context control
  • Full-text and vector search
  • MCP Server
  • Multi-language UI
  • Multi-modal content ingestion
  • Multi-model AI provider support
  • Notes
  • Podcast Generation
  • Reasoning model support
  • REST API
  • Run AI models locally

open-notebook README

How to install open-notebook

Install open-notebook with Docker Compose

Environment variables
OPEN_NOTEBOOK_ENCRYPTION_KEY, SURREAL_URL, SURREAL_USER, SURREAL_PASSWORD, OPEN_NOTEBOOK_PASSWORD

Step 1: Download the compose file

Create a folder for Open Notebook and download the compose file into it:

mkdir open-notebook
cd open-notebook
curl -o docker-compose.yml https://raw.githubusercontent.com/lfnovo/open-notebook/main/docker-compose.yml

Step 2: Set your encryption key

Open docker-compose.yml and find this line in the open_notebook service:

      - OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string

Replace change-me-to-a-secret-string with a long random secret that you generate yourself.

Step 4: Start Open Notebook

docker compose up -d

Recommended route; starts the `surrealdb` and `open_notebook` services.

How to configure open-notebook

  • OPEN_NOTEBOOK_ENCRYPTION_KEYSecret used to encrypt AI provider keys in the database. Use a unique high-entropy value you generate, for example with `openssl rand -hex 32`; the PBKDF2 stretching can't protect a guessable one. Required to save credentials in Manage → Models. If you change or lose it, stored keys can no longer be decrypted. Do not keep the `change-me-to-a-secret-string` value from the shipped compose file. See
  • SURREAL_URLbuilt from SURREAL_ADDRESS/SURREAL_PORTWebSocket URL, e.g. `ws://surrealdb:8000/rpc` (compose) or `ws://localhost:8000/rpc` (from source). See Database
  • SURREAL_USERnone in the API (sign-in fails); test in the job queueSurrealDB user. Must match the `--user` the database was started with
  • SURREAL_PASSWORDroot in the API; test in the job queueSurrealDB password. Must match `--pass`. Change it before exposing the instance
  • SURREAL_NAMESPACEopen_notebook in the API; test in the job queueSurrealDB namespace

open-notebook releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Is this right for me?

The project targets learning enthusiasts, people who want a tailor-made AI learning partner, those with a large backlog of links to catalogue, independent thinkers, privacy-aware users and people who want to decide how their content is handled.

More in Knowledge Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…