---
title: Command and configuration reference
description: Find Compose commands, source startup options, and data directory settings.
lastVerified: 2026-09-23
---

# 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](https://docs.teloa.ai/v/0.2.10/markdown/en/start/quickstart.md) for ways to run Teloa and local execution boundaries.

## 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):

```sh
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](https://docs.teloa.ai/v/0.2.10/markdown/en/deploy/configuration.md#oauth-callback-address) |

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.