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
    

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

Details

Repository
ghcr.io/modsetter/surfsense_ui:latest
Last Updated2026-05-31
First Seen2025-06-05

Run SurfSense---Frontend on Unraid.

SurfSense---Frontend is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.