LobeHub with RustFS

LobeHub is an open-source, extensible, high-performance AI chat framework. This template follows the official LobeHub Docker Compose architecture, using RustFS as S3-compatible storage (Apache 2.0 license) and Redis for caching.

Architecture (5 services)

• PostgreSQL (ParadeDB pg17 with pgvector + pg_search)
• Redis (session cache & performance)
• RustFS (S3-compatible object storage)
• RustFS-Init (bucket initialization with public-read policy)
• LobeHub (main application)

Required Setup After Deployment

JWKS Key (Required)

The JWKS_KEY environment variable is included (empty by default). LobeHub features like image generation, desktop client auth, and async tasks require it.

Generate it with one click at the official docs: https://lobehub.com/docs/self-hosting/environment-variables/auth#jwks-key

Then fill the JWKS_KEY value in the LobeHub service environment variables.

Optional Features (fill API keys in LobeHub service env vars)

Web Search (Tavily) — pre-configured, needs API key

TAVILY_API_KEY is empty by default. Get a key at https://www.tavily.com/ and fill it in. Search and crawler are both pre-set to use Tavily with advanced depth.

Knowledge Base Embedding (AiHubMix) — pre-configured, needs API key

AIHUBMIX_API_KEY is empty by default. Get a key at https://aihubmix.com/ and fill it in. Embedding model is pre-set to aihubmix/jina-embeddings-v4.

AI Model Providers

Configure your model provider API keys (OpenAI, Claude, Gemini, DeepSeek, etc.) in the LobeHub settings UI or as environment variables.

Notes

• Authentication uses Better Auth email + password by default (no SSO required).
• S3_ENDPOINT uses the public RustFS domain so browsers and LLM providers can access uploaded files.
• RustFS uses a bucket policy (not per-object ACL) for public read, so S3_SET_ACL=0.