SurfSense Worker
SurfSense is an air-gapped, open-source alternative to NotebookLM.
Platform availability
Available on 4 of 10 platforms
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
Variants
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
- Open Source Alternative to NotebookLM : r/selfhosted - Reddit (reddit)
- Reddit (reddit)
- Microsoft Surface Forums (forum)
- I'm making an app that allows surfers to rate their surf ... - Reddit (reddit)
- SurfSense on Windows: Local PDF Chat, Model Choice and Privacy Limits ... (forum)
Collected 48 days ago - public community threads