Configuration

Configuration

The daemon and the CLI are configured with environment variables, all prefixed AV_.

Lite mode

Variable	Default	Meaning
AV_HOME	~/.scholion	Daemon data: pg/ (Postgres), store/ (jj repositories), daemon.log, daemon.pid
AV_WS_ROOT	~/ws	Where task workspaces appear (agents edit files here)
AV_DATABASE_URL	(none)	Use this Postgres instead of the daemon's own
AV_PG_DIR	$AV_HOME/pg	Data, password and binaries of the daemon's own Postgres
AV_PG_INSTALL_DIR	(none)	An existing PostgreSQL 16 installation (the directory holding bin/) instead of the bundled one
AV_DAEMON_BIN	next to av, else PATH	The scholion-daemon that av up starts

Daemon and Docker stack

Variable	Default	Meaning
AV_IMPORT_ROOT	~/projects	Host directory mounted read-only at /import for av repo add
AV_PG_PORT	5432	Localhost port of the Postgres container
AV_QDRANT_PORT / AV_QDRANT_GRPC_PORT	6333 / 6334	Localhost ports of the Qdrant container
AV_QDRANT_URL	(none)	Qdrant gRPC URL; semantic search is off without it
AV_TEI_PORT	8080	Localhost port of the embedding server
AV_DAEMON_PORT	7420	Localhost port of the daemon
AV_WS_MOUNT / AV_IMPORT_MOUNT	AV_WS_ROOT / AV_IMPORT_ROOT	Bind-mount sources, when Docker sees the folders under another path
AV_EMBED_PROVIDER	auto	ollama or api. Auto uses Ollama when it has a qwen3-embedding model
AV_EMBED_URL	(none)	Embedding API base URL; required when there is no Ollama
AV_EMBED_API_KEY	(none)	Bearer token for the embedding API
AV_OLLAMA_URL	http://127.0.0.1:11434	Ollama server
AV_PG_MAX_CONNECTIONS	16	Postgres pool size; raise it when many agents work at once
AV_MAX_CONCURRENT_STARTS	a quarter of the pool	Task starts that run at once; the others wait their turn
AV_LEASE_SECS	1800	How long an agent holds an open task without writing to it before another may claim it
AV_TOKEN	(none)	Shared bearer token for every route but /healthz and /ui. Unset = no auth
AV_BACKUP_REMOTES	(none)	repo=url pairs, whitespace-separated; main is pushed there after every merge and undo

CLI and hooks

Variable	Default	Meaning
AV_URL	http://127.0.0.1:7420	Daemon address
AV_AGENT	(none)	This agent's name (same as --agent)
AV_SESSION	(none)	Ledger session id, overriding the one in .av-task
AV_TOKEN	(none)	Sent as Authorization: Bearer
AV_HOOK_WAIT_SECS	600	How long the Claude Code Stop hook waits for new work (0 = off)
AV_HOOK_MAX_CONTINUES	20	How many times the Stop hook continues one session
AV_CONTEXT_FILE	(none)	Where av-wrap.sh writes the pack

Repo settings

av repo settings NAME --check "python -m pytest -q"   # the post-merge check
av repo backup NAME --remote URL [--branch BRANCH]    # backup remote