SurfSense---Frontend

SurfSense---Frontend

Docker app from grtgbln's Repository

Overview

Open Source Alternative to NotebookLM / Perplexity / Glean, connected to external sources such as search engines (Tavily, Linkup), Slack, Linear, Notion, YouTube, GitHub, Discord and more.
This is the frontend container.

Requirements


        Requires separate SurfSense - Backend, SurfSense - Worker, pgAdmin4, pgvector, electric and Redis containers. See documentation: https://github.com/MODSetter/SurfSense/blob/main/DOCKER_SETUP.md#deployment-options
    

Related apps

Details

Repository
ghcr.io/modsetter/surfsense-web:latest
Last Updated2026-10-27
First Seen2026-10-27

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 3000

Target
3000
Default
3000
Value
3000
Backend - URLVariable

URL of the backend service, including port

Target
NEXT_PUBLIC_API_URL
Default
http://MY_IP_ADDRESS:3001
Value
http://MY_IP_ADDRESS:3001
Backend - URLVariable

URL of the FastAPI backend service, including port. Should match other Backend URL.

Target
NEXT_PUBLIC_FASTAPI_BACKEND_URL
Default
http://MY_IP_ADDRESS:3001
Value
http://MY_IP_ADDRESS:3001
Backend - Authentication TypeVariable

Authentication type used by the backend.

Target
NEXT_PUBLIC_FASTAPI_BACKEND_AUTH_TYPE
Default
LOCAL|GOOGLE
Backend - ETL ServiceVariable

Document parsing service used by the backend.

Target
NEXT_PUBLIC_ETL_SERVICE
Default
UNSTRUCTURED|LLAMACLOUD|DOCLING
Database - Postgres URLVariable

PostgreSQL database connection URL

Target
DATABASE_URL
Default
postgresql://postgres:MY_PASSWORD@db.sdsf.supabase.co:5432/postgres
Value
postgresql://postgres:MY_PASSWORD@db.sdsf.supabase.co:5432/postgres
Electric - URLVariable

URL of the Electric service, including port

Target
NEXT_PUBLIC_ELECTRIC_URL
Default
http://MY_IP_ADDRESS:5133
Value
http://MY_IP_ADDRESS:5133
Electric - Auth ModeVariable

Authentication mode for Electric service

Target
NEXT_PUBLIC_ELECTRIC_AUTH_MODE
Default
insecure
Value
insecure
App DataPath

Path to the data folder

Target
/app
Default
/mnt/user/appdata/surfsense/frontend/data
Value
/mnt/user/appdata/surfsense/frontend/data
App Node ModulesPath

Path to node modules

Target
/app/node_modules
Default
/mnt/user/appdata/surfsense/frontend/node_modules
Value
/mnt/user/appdata/surfsense/frontend/node_modules