SurfSense Worker

SurfSense is an air-gapped, open-source alternative to NotebookLM.

  • AI
  • Tools & Utilities
SurfSense is an air-gapped, open-source alternative to NotebookLM. It's a self-hosted AI agent that researches, transforms, and edits your documents locally on your own hardware, keeping your data private. It's for anyone who wants a private, local document-analysis assistant instead of a cloud service.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows
  • Linux
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
100last commit 18 days ago
Popular
8516,892 GitHub stars
Easy to install
453 install platforms, install notes
Light to run
304 GB minimum RAM
GitHub stars
16,892
Open issues
65
Last commit
2026-11-03
Latest release
v2.3.1
License
Apache-2.0
Activity
declining

Checked 3 days ago - source: GitHub (MODSetter/SurfSense)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 2 CPU core(s), 200 MB disk.

Checked 42 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Use Docker with a data volume and ports Run the all-in-one Docker command while keeping the Docker data volume (-v surfsense-data:/data) and the listed ports (3000, 8000, and 5133). This stores your files in a Docker storage area that survives container recreation, and port 3000 is the web page you open at http://localhost:3000 while the other ports let the backend and Electric SQL (the change-streaming service) work. source
  • Create .env files before starting Create your .env files from the .env.example files before starting SurfSense if you want custom settings, and keep them private because they hold configuration such as SECRET_KEY. Missing them can make the app start with defaults, and an auto-generated SECRET_KEY may later cause sessions or security settings to not match what you expect. source
  • Enable logical replication for Electric SQL If you use your own PostgreSQL (the database) with Electric SQL, add the logical replication settings that let the app watch for database changes to its postgresql.conf configuration file. Electric SQL needs this to detect changes and send updates to the frontend; without it, new or changed records may not appear in the app. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which Docker volume and ports should I keep when installing the all-in-one Docker stack?

Keep the Docker data volume surfsense-data mounted to /data and expose ports 3000, 8000, and 5133. Port 3000 is the web interface on localhost, while the other ports let the backend and Electric SQL work.

Do I need to create .env files before starting SurfSense?

Create your .env files from the .env.example files before starting SurfSense if you want custom settings. Keep them private because they hold configuration such as SECRET_KEY, and missing them can make the app start with defaults or an auto-generated key that later mismatches.

Do I need a cloud account to use SurfSense self-hosted?

No. It is described as air-gapped and self-hosted, with your documents and model keys staying local and no cloud or account required.

Is the self-hosted Docker stack supported by the vendor?

The Docker stack is open source and installable, but it is community-supported with no SLA or hosted service. The desktop app is described as the supported path for new users.

Answers sourced from github.com, www.surfsense.com, www.surfsense.com, www.surfsense.com

Community

Collected 48 days ago - public community threads