SurfSense---Backend

SurfSense---Backend

Application Docker from grtgbln's Repository

Vue d'ensemble

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.

Exigences


        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
    

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:8000]/
Réseau
bridge
Privilégié
false

Configuration du modèle

API PortPorttcp

Container Port: 8000

Cible
8000
Défaut
3001
Valeur
3001
Database - URLVariable

URL of the PostgreSQL database, including port and credentials

Cible
DATABASE_URL
Défaut
postgresql+asyncpg://USERNAME:PASSWORD@IP_ADDRESS:5432/surfsense
Valeur
postgresql+asyncpg://USERNAME:PASSWORD@IP_ADDRESS:5432/surfsense
Secret KeyVariable

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

Cible
SECRET_KEY
Frontend URLVariable

URL of the frontend service, including port

Cible
NEXT_FRONTEND_URL
Défaut
http://MY_IP_ADDRESS:3000
Valeur
http://MY_IP_ADDRESS:3000
Authentication - TypeVariable

Authentication type (Google OAuth or local email/password)

Cible
AUTH_TYPE
Défaut
LOCAL|GOOGLE
Authentication - Google Client IDVariable

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

Cible
GOOGLE_OAUTH_CLIENT_ID
Authentication - Google Client SecretVariable

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

Cible
GOOGLE_OAUTH_CLIENT_SECRET
Google - Calendar Redirect URIVariable

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

Cible
GOOGLE_CALENDAR_REDIRECT_URI
Défaut
http://MY_IP_ADDRESS:8000/api/v1/auth/google/calendar/connector/callback
Valeur
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.

Cible
GOOGLE_GMAIL_REDIRECT_URI
Défaut
http://MY_IP_ADDRESS:8000/api/v1/auth/google/gmail/connector/callback
Valeur
http://MY_IP_ADDRESS:8000/api/v1/auth/google/gmail/connector/callback
AirTable - Client IDVariable

AirTable OAuth Client ID. Required if using AirTable connector.

Cible
AIRTABLE_CLIENT_ID
AirTable - Client SecretVariable

AirTable OAuth Client Secret. Required if using AirTable connector.

Cible
AIRTABLE_CLIENT_SECRET
AirTable - Redirect URIVariable

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

Cible
AIRTABLE_REDIRECT_URI
Défaut
http://MY_IP_ADDRESS:8000/api/v1/auth/airtable/connector/callback
Valeur
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)

Cible
EMBEDDING_MODEL
Défaut
mixedbread-ai/mxbai-embed-large-v1
Valeur
mixedbread-ai/mxbai-embed-large-v1
Models - Reranker ModelVariable

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

Cible
RERANKERS_MODEL_NAME
Défaut
ms-marco-MiniLM-L-12-v2
Valeur
ms-marco-MiniLM-L-12-v2
Models - Reranker Model TypeVariable

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

Cible
RERANKERS_MODEL_TYPE
Défaut
flashrank
Valeur
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

Cible
TTS_SERVICE
Défaut
openai/tts-1
Valeur
openai/tts-1
LiteLLM - Text To Speech API BaseVariable

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

Cible
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.

Cible
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

Cible
STT_SERVICE
Défaut
openai/whisper-1
Valeur
openai/whisper-1
LiteLLM - Speech To Text Local ModelVariable

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

Cible
LOCAL_STT_MODEL
Défaut
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.

Cible
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.

Cible
STT_SERVICE_API_KEY
Firecrawl - API KeyVariable

API key for Firecrawl service for web crawling

Cible
FIRECRAWL_API_KEY
ETL ServiceVariable

Document parsing service

Cible
ETL_SERVICE
Défaut
UNSTRUCTURED|LLAMACLOUD|DOCLING
Unstructured - API KeyVariable

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

Cible
UNSTRUCTURED_API_KEY
LlamaCloud - API KeyVariable

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

Cible
LLAMA_CLOUD_API_KEY
Redis - URLVariable

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

Cible
CELERY_BROKER_URL
Défaut
redis://MY_IP_ADDRESS:6379/0
Valeur
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

Cible
CELERY_RESULT_BACKEND
Défaut
redis://MY_IP_ADDRESS:6379/0
Valeur
redis://MY_IP_ADDRESS:6379/0
Electric - UserVariable

Electric database user

Cible
ELECTRIC_DB_USER
Défaut
electric
Valeur
electric
Electric - PasswordVariable

Electric database password

Cible
ELECTRIC_DB_PASSWORD
Défaut
electric_password
Valeur
electric_password
App DataPath

Path to store app data. Must match Worker

Cible
/app
Défaut
/mnt/user/appdata/surfsense/backend/data
Valeur
/mnt/user/appdata/surfsense/backend/data
Temp DataPath

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

Cible
/tmp
Défaut
/mnt/user/appdata/surfsense/shared/tmp
Valeur
/mnt/user/appdata/surfsense/shared/tmp
LangSmith - TracingVariable

Enable LangSmith tracing.

Cible
LANGSMITH_TRACING
Défaut
false
Valeur
false
LangSmith - EndpointVariable

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

Cible
LANGSMITH_ENDPOINT
Défaut
https://api.smith.langchain.com
Valeur
https://api.smith.langchain.com
LangSmith - Project NameVariable

LangSmith project name.

Cible
LANGSMITH_PROJECT
LangSmith - API KeyVariable

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

Cible
LANGSMITH_API_KEY
Uvicorn - HostVariable

Uvicorn host address. Not recommended to change.

Cible
UVICORN_HOST
Défaut
0.0.0.0
Valeur
0.0.0.0
Uvicorn - PortVariable

Uvicorn port. Not recommended to change.

Cible
UVICORN_PORT
Défaut
8000
Valeur
8000
Uvicorn - Log LevelVariable

Uvicorn log level. Not recommended to change.

Cible
UVICORN_LOG_LEVEL
Défaut
info
Valeur
info
Uvicorn - LoopVariable

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

Cible
UVICORN_LOOP
Défaut
asyncio
Valeur
asyncio
Internal Python PathVariable

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

Cible
PYTHONPATH
Défaut
/app
Valeur
/app
Unstructured Has Patched LoopVariable

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

Cible
UNSTRUCTURED_HAS_PATCHED_LOOP
Défaut
1
Valeur
1
LangChain - Tracing V2Variable

Not recommended to change.

Cible
LANGCHAIN_TRACING_V2
Défaut
false
Valeur
false

Détails

Référentiel
ghcr.io/modsetter/surfsense_backend:latest
Dernière mise à jour2026-05-31
Première vue2025-06-05

Exécutez SurfSense---Backend sur Unraid.

SurfSense---Backend est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.