SurfSense---Backend

SurfSense---Backend

Docker-Anwendung from grtgbln's Repository

Übersicht

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 backend container.

Anforderungen


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

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:8000]/
Netzwerk
bridge
Privilegiert
false

Konfiguration der Vorlage

API PortPorttcp

Container Port: 8000

Ziel
8000
Standard
3001
Wert
3001
Database - URLVariable

URL of the PostgreSQL database, including port and credentials

Ziel
DATABASE_URL
Standard
postgresql+asyncpg://USERNAME:PASSWORD@IP_ADDRESS:5432/surfsense
Wert
postgresql+asyncpg://USERNAME:PASSWORD@IP_ADDRESS:5432/surfsense
Secret KeyVariable

JWT Secret key for authentication (should be a secure random string)

Ziel
SECRET_KEY
Frontend URLVariable

URL of the frontend service, including port

Ziel
NEXT_FRONTEND_URL
Standard
http://MY_IP_ADDRESS:3000
Wert
http://MY_IP_ADDRESS:3000
Authentication - TypeVariable

Authentication type (Google OAuth or local email/password)

Ziel
AUTH_TYPE
Standard
LOCAL|GOOGLE
Authentication - Google Client IDVariable

Google OAuth Client ID. Required if AUTH_TYPE is set to GOOGLE.

Ziel
GOOGLE_OAUTH_CLIENT_ID
Authentication - Google Client SecretVariable

Google OAuth Client Secret. Required if AUTH_TYPE is set to GOOGLE.

Ziel
GOOGLE_OAUTH_CLIENT_SECRET
Google - Calendar Redirect URIVariable

Redirect URI for Google Calendar OAuth. Must match the one set in Google Cloud Console.

Ziel
GOOGLE_CALENDAR_REDIRECT_URI
Standard
http://MY_IP_ADDRESS:8000/api/v1/auth/google/calendar/connector/callback
Wert
http://MY_IP_ADDRESS:8000/api/v1/auth/google/calendar/connector/callback
Google - Gmail Redirect URIVariable

Redirect URI for Google Gmail OAuth. Must match the one set in Google Cloud Console.

Ziel
GOOGLE_GMAIL_REDIRECT_URI
Standard
http://MY_IP_ADDRESS:8000/api/v1/auth/google/gmail/connector/callback
Wert
http://MY_IP_ADDRESS:8000/api/v1/auth/google/gmail/connector/callback
AirTable - Client IDVariable

AirTable OAuth Client ID. Required if using AirTable connector.

Ziel
AIRTABLE_CLIENT_ID
AirTable - Client SecretVariable

AirTable OAuth Client Secret. Required if using AirTable connector.

Ziel
AIRTABLE_CLIENT_SECRET
AirTable - Redirect URIVariable

Redirect URI for AirTable OAuth. Must match the one set in AirTable developer console.

Ziel
AIRTABLE_REDIRECT_URI
Standard
http://MY_IP_ADDRESS:8000/api/v1/auth/airtable/connector/callback
Wert
http://MY_IP_ADDRESS:8000/api/v1/auth/airtable/connector/callback
Models - Embedder ModelVariable

Name of the embedding model (e.g., openai://text-embedding-ada-002, anthropic://claude-v1, mixedbread-ai/mxbai-embed-large-v1)

Ziel
EMBEDDING_MODEL
Standard
mixedbread-ai/mxbai-embed-large-v1
Wert
mixedbread-ai/mxbai-embed-large-v1
Models - Reranker ModelVariable

Name of the reranker model (e.g., ms-marco-MiniLM-L-12-v2)

Ziel
RERANKERS_MODEL_NAME
Standard
ms-marco-MiniLM-L-12-v2
Wert
ms-marco-MiniLM-L-12-v2
Models - Reranker Model TypeVariable

Type of reranker model (e.g., flashrank)

Ziel
RERANKERS_MODEL_TYPE
Standard
flashrank
Wert
flashrank
LiteLLM - Text To Speech ServiceVariable

Text-to-Speech API provider for Podcasts (e.g., openai/tts-1, azure/neural, vertex_ai/). See documentation: https://docs.litellm.ai/docs/text_to_speech#supported-providers

Ziel
TTS_SERVICE
Standard
openai/tts-1
Wert
openai/tts-1
LiteLLM - Text To Speech API BaseVariable

Base URL for the Text To Speech API. Optional, leave empty to use default.

Ziel
TTS_SERVICE_API_BASE
LiteLLM - Text To Speech API KeyVariable

API Key for the Text To Speech API provider. Required if the provider needs authentication.

Ziel
TTS_SERVICE_API_KEY
LiteLLM - Speech To Text ServiceVariable

Speech-to-Text API provider for Podcasts (e.g., openai/whisper-1, local). See documentation: https://docs.litellm.ai/docs/audio_transcription#supported-providers

Ziel
STT_SERVICE
Standard
openai/whisper-1
Wert
openai/whisper-1
LiteLLM - Speech To Text Local ModelVariable

Local Whisper model size to use if STT_SERVICE is set to local.

Ziel
LOCAL_STT_MODEL
Standard
base|tiny|small|medium|large-v3
LiteLLM - Speech To Text API BaseVariable

Base URL for the Speech To Text API. Optional, leave empty to use default.

Ziel
STT_SERVICE_API_BASE
LiteLLM - Speech To Text API KeyVariable

API Key for the Speech To Text API provider. Required if the provider needs authentication.

Ziel
STT_SERVICE_API_KEY
Firecrawl - API KeyVariable

API key for Firecrawl service for web crawling

Ziel
FIRECRAWL_API_KEY
ETL ServiceVariable

Document parsing service

Ziel
ETL_SERVICE
Standard
UNSTRUCTURED|LLAMACLOUD|DOCLING
Unstructured - API KeyVariable

API key for Unstructured.io service for document parsing. Required if ETL Service is set to UNSTRUCTURED

Ziel
UNSTRUCTURED_API_KEY
LlamaCloud - API KeyVariable

API key for LlamaCloud service for document parsing. Required if ETL Service is set to LLAMACLOUD

Ziel
LLAMA_CLOUD_API_KEY
Redis - URLVariable

URL of the Redis instance used as Celery broker, including port

Ziel
CELERY_BROKER_URL
Standard
redis://MY_IP_ADDRESS:6379/0
Wert
redis://MY_IP_ADDRESS:6379/0
Redis - Results URLVariable

URL of the Redis instance used as Celery result backend, including port. Must match CELERY_BROKER_URL

Ziel
CELERY_RESULT_BACKEND
Standard
redis://MY_IP_ADDRESS:6379/0
Wert
redis://MY_IP_ADDRESS:6379/0
Electric - UserVariable

Electric database user

Ziel
ELECTRIC_DB_USER
Standard
electric
Wert
electric
Electric - PasswordVariable

Electric database password

Ziel
ELECTRIC_DB_PASSWORD
Standard
electric_password
Wert
electric_password
App DataPath

Path to store app data. Must match Worker

Ziel
/app
Standard
/mnt/user/appdata/surfsense/backend/data
Wert
/mnt/user/appdata/surfsense/backend/data
Temp DataPath

Path to store temporary data. Must be shared between containers.

Ziel
/tmp
Standard
/mnt/user/appdata/surfsense/shared/tmp
Wert
/mnt/user/appdata/surfsense/shared/tmp
LangSmith - TracingVariable

Enable LangSmith tracing.

Ziel
LANGSMITH_TRACING
Standard
false
Wert
false
LangSmith - EndpointVariable

LangSmith API endpoint. Default is https://api.smith.langchain.com, change only if you know what you're doing.

Ziel
LANGSMITH_ENDPOINT
Standard
https://api.smith.langchain.com
Wert
https://api.smith.langchain.com
LangSmith - Project NameVariable

LangSmith project name.

Ziel
LANGSMITH_PROJECT
LangSmith - API KeyVariable

API key for LangSmith tracing. Required if LANGSMITH_TRACING is enabled.

Ziel
LANGSMITH_API_KEY
Uvicorn - HostVariable

Uvicorn host address. Not recommended to change.

Ziel
UVICORN_HOST
Standard
0.0.0.0
Wert
0.0.0.0
Uvicorn - PortVariable

Uvicorn port. Not recommended to change.

Ziel
UVICORN_PORT
Standard
8000
Wert
8000
Uvicorn - Log LevelVariable

Uvicorn log level. Not recommended to change.

Ziel
UVICORN_LOG_LEVEL
Standard
info
Wert
info
Uvicorn - LoopVariable

Uvicorn loop type. Default is asyncio, change only if you know what you're doing.

Ziel
UVICORN_LOOP
Standard
asyncio
Wert
asyncio
Internal Python PathVariable

Internal Python path for the application. Not recommended to change.

Ziel
PYTHONPATH
Standard
/app
Wert
/app
Unstructured Has Patched LoopVariable

Unstructured library patched loop. Default is 1, change only if you know what you're doing.

Ziel
UNSTRUCTURED_HAS_PATCHED_LOOP
Standard
1
Wert
1
LangChain - Tracing V2Variable

Not recommended to change.

Ziel
LANGCHAIN_TRACING_V2
Standard
false
Wert
false

Einzelheiten

Repository
ghcr.io/modsetter/surfsense_backend:latest
Zuletzt aktualisiert2026-05-31
Erstmals gesehen2025-06-05

Führen Sie SurfSense---Backend auf Unraid aus.

SurfSense---Backend ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.