7.1 Command and configuration reference

For everyday use, follow the installation guide first. Change configuration only after understanding where it applies and what it affects.

The Compose commands apply to this version’s downloadable configuration and source workflow. For npm, run teloa --help for the version’s installation, lifecycle, backup and upgrade options. See the installation guide for ways to run Teloa and local execution boundaries.

The current stable release is 0.2.31, with data version 18 and direct compatibility [18]. Use the matching CLI for native maintenance; upgrades retain the original home and automatic backup. See backup and upgrades.

Compose commands

Run these in the installation directory containing compose.yaml (start Hub images with docker compose up -d --no-build; use --build only when building from source):

docker compose up -d --build
docker compose ps
docker compose logs --tail=50 app
docker compose stop
docker compose start

Logs may contain the current authentication URL. View them in your own terminal and do not paste them directly into a public issue. stop preserves containers and data volumes. Do not use options that delete data volumes as a routine way to restart.

Configuration options

Name	Default	Purpose
TELOA_PORT	3100	Web port that Compose maps to your computer
TELOA_DSH_PORT	3100	Web port when running from source (default 3100); Compose listens on a fixed container port and maps it with TELOA_PORT
TELOA_DSH_HOME	.runtime/dsh	DSH data directory when running from source
TELOA_RUNTIME_ROOT	.runtime/teloa	Business data directory when running from source
TELOA_WORKSPACE_ROOT	workspace under the data directory	Working files and the default sandbox working directory
TELOA_DSH_PROFILE	teloa	Run configuration identity
TELOA_OAUTH_PUBLIC_CALLBACK_URL	none	Public HTTPS OAuth callback for server deployments; used only when config.json in the data directory does not set oauth.publicCallbackUrl. The npm-installed teloa command does not pass this variable; use config.json instead. See Configuration and data locations

Compose stores data directories under /data in persistent volumes. Changing a directory or profile does not migrate existing data. Acceptance environments require the full set of isolation parameters; use the dedicated launcher.

Configure model keys in Settings, not through these port variables. Whichever edition you use, you pay for your own model usage.