env.example

# RockGPT deployment configuration.
#
# Copy this file to ".env" in the repository root and adjust the values:
#
#     cp env.example .env
#     chmod 600 .env
#
# Docker Compose reads ".env" automatically, so the whole stack is described by
# the repository plus this single file: no environment variables have to be
# exported by hand on the command line. ".env" is gitignored and must never be
# committed, because it holds the API keys.
#
# Every variable below is optional: the defaults in compose.yml are used when a
# variable is missing or empty.

# --- Image tags -------------------------------------------------------------
# Pin both tags explicitly. Open WebUI migrates its database forward on start
# and cannot migrate it back, so an accidental downgrade breaks the deployment.
OLLAMA_DOCKER_TAG=0.24.0
WEBUI_DOCKER_TAG=v0.11.3-cuda

# --- Host ports -------------------------------------------------------------
OPEN_WEBUI_PORT=8585
OLLAMA_PORT=11434

# --- Open WebUI -------------------------------------------------------------
# Authentication. "False" opens the interface directly on the preloaded admin
# account, with no login prompt: acceptable on a laptop, not on a host that is
# reachable from the network. Set it to "True" there.
WEBUI_AUTH=False

# Session signing key. Leave empty to let Open WebUI generate and persist one on
# first start. Set it explicitly to keep sessions valid across a redeployment
# with an empty data directory, e.g. openssl rand -hex 32
WEBUI_SECRET_KEY=

# Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL
GLOBAL_LOG_LEVEL=INFO

# Default parameters applied to every model, as JSON.
#
# Open WebUI 0.11 changed the function calling default to "native": the tool
# list is attached to every request, and models without tool support fail hard.
# Ollama answers 400 "<model> does not support tools", an OpenAI-compatible
# gateway answers 500, and the user just sees an empty reply. "legacy" is the
# prompt-based mode used up to 0.9.x, and it works with every model.
#
# Careful: this only seeds a fresh database. On an existing deployment the value
# is already stored, and it has to be changed in the interface, under
# Admin Settings > Models > Model Defaults > Model Parameters > Function Calling.
DEFAULT_MODEL_PARAMS={"function_calling":"legacy"}

# Model used for background tasks (chat title, tags, follow-up questions) when
# the chat itself runs on an external, OpenAI-compatible backend.
#
# Empty means "reuse the chat model", but 0.11 forwards it as an empty model id
# and the gateway rejects it: the string "Model '' was not found" then shows up
# inside the reply. Name a small local model instead, e.g. phi4:latest.
#
# Same caveat as above: seeds a fresh database only. On an existing deployment,
# change it under Admin Settings > Interface > Tasks > External Task Model.
TASK_MODEL_EXTERNAL=

# --- Optional OpenAI-compatible backend -------------------------------------
# Additional inference backend exposed alongside Ollama, e.g. an on-premise
# gateway. Leave both empty to run on Ollama only. Comma-separated lists are
# allowed, and the Nth key is paired with the Nth base URL.
OPENAI_API_BASE_URLS=
OPENAI_API_KEYS=