11# Root environment variables for docker-compose.selfhost.yaml
22# Copy this file to .env in the same directory (src/.env) and fill in the values.
33
4- # --- Client (Frontend) Variables ---
5- # The public-facing URL of your client application.
6- # [BUILD-TIME & RUNTIME] Crucial for OAuth redirects and server-side requests.
4+ # --- Public URLs ---
5+ # These are the URLs that users will use in their browser to access the application.
6+ # For a standard local setup, these defaults are correct.
7+ # If you expose this on the internet, change localhost to your domain.
78APP_BASE_URL=http://localhost:3000
89NEXT_PUBLIC_APP_BASE_URL=http://localhost:3000
9-
10- # The URL where the backend server will be accessible from the user's browser
11- # [BUILD-TIME & RUNTIME] Used by the client to make API calls.
1210NEXT_PUBLIC_APP_SERVER_URL=http://localhost:5000
1311
14- # The internal URL for the backend server, used for server-to-server communication inside Docker.
15- # [BUILD-TIME & RUNTIME] Used by the client's Next.js server to talk to the backend server .
12+ # --- Internal Docker URLs ---
13+ # These are for container-to-container communication and should not be changed .
1614INTERNAL_APP_SERVER_URL=http://server:80
17-
18- # The internal URL for the client container, used for server-side self-requests
19- # [BUILD-TIME & RUNTIME] Used for OAuth callbacks within the Docker network.
2015INTERNAL_CLIENT_URL=http://client:3000
2116
22- # The mode to run the application in
23- # [BUILD-TIME & RUNTIME] Switches between Auth0 and self-host auth mode.
17+ # --- Authentication ---
18+ # Sets the application to run in self-hosted mode. Do not change .
2419NEXT_PUBLIC_ENVIRONMENT=selfhost
25-
26- # [BUILD-TIME & RUNTIME] A long, random, secret string. It must match SELF_HOST_AUTH_SECRET in server/.env.selfhost.template
20+ # A long, random, secret string that acts as your master password for the app.
21+ # It must be the same in all three .env files where it appears.
22+ # Generate a strong secret here (e.g., using a password manager or `openssl rand -hex 32`).
2723SELF_HOST_AUTH_TOKEN=<generate_a_strong_secret_here>
2824
2925# --- Server (Backend) Build-Time Variables ---
3026# [BUILD-TIME] Set OPENAI_API_KEY to "ollama" to install Ollama in the server container.
31- # Otherwise, provide your key for a remote service.
27+ # This allows you to run a local LLM without needing an external API key for chat.
28+ # To use a remote service (like OpenAI or another provider via LiteLLM), provide your key here.
3229OPENAI_API_KEY=ollama
33- # [BUILD-TIME] The model to pull if Ollama is being installed. This should match the model in the server's Modelfile.
30+ # [BUILD-TIME] The model to pull if Ollama is being installed. This should match the model
31+ # in the server's Modelfile and the OPENAI_MODEL_NAME in server/.env.selfhost.
3432OPENAI_MODEL_NAME=qwen3:4b
3533
36- # --- Gemini API Key (for Server - Memory MCP & optional LiteLLM) ---
37- # [RUNTIME] Required for memory embeddings and can be used for chat via LiteLLM.
34+ # --- Gemini API Key (for Server - Memory & optional LiteLLM) ---
35+ # [RUNTIME] Required for memory embeddings and can be used for chat via the LiteLLM proxy.
36+ # Get this from Google AI Studio.
3837GEMINI_API_KEY=<your-gemini-api-key>
3938
4039# --- MongoDB Credentials (for Server) ---
41- MONGO_USER=test
40+ MONGO_USER=sentient
4241MONGO_PASS=<generate_a_strong_password_for_mongo>
4342
4443# --- PostgreSQL Credentials (for Server - Memory MCP) ---
@@ -51,6 +50,7 @@ REDIS_PASSWORD=<generate_a_strong_password_for_redis>
5150
5251# --- WhatsApp (WAHA) Credentials (for WAHA Service) ---
5352# These are used by the WAHA container for WhatsApp integration.
53+ # You can leave these as default for a local setup.
5454WAHA_API_KEY=admin
5555WAHA_DASHBOARD_USERNAME=admin
5656WAHA_DASHBOARD_PASSWORD=admin
0 commit comments