Configuration
This page lists every environment variable and command-line flag the app environment reads, with the default of each and what it changes.

You configure the app environment with environment variables and command-line flags. This page lists all of them. For example, SEED_APPS_HTTP_PORT=3051 makes the server listen on port 3051, and so does the flag --server-port 3051.

The first thing to check: /api/health reports several of the values in use, so you can see what a running server was started with. The code reads every setting in one file, apps/src/config.ts. Environments says which settings each setup uses, and operations sends you to the task pages.

Names

Each setting is an environment variable named SEED_APPS_<NAME>. The server also reads the older spelling SEED_AGENTS_<NAME> for every setting. When both are set, the SEED_APPS_ name wins. The self-hosting compose files and the hosted Seed servers set the older spelling. These pages write the SEED_APPS_ form.

Environment variables

Environment variable

Default

Purpose

SEED_APPS_HTTP_HOSTNAME

0.0.0.0

HTTP bind hostname.

SEED_APPS_HTTP_PORT

3050

HTTP port.

SEED_APPS_DB_PATH

./data/agents.sqlite

SQLite DB path.

SEED_APPS_DATA_DIR

./data

Data directory.

SEED_APPS_HM_SERVER_URL

https://hyper.media

The Seed API the server reads and writes through: the /api/* endpoint that speaks DAG-CBOR. The server uses it for the activity feed and for every HM read and write.

SEED_APPS_HM_SERVER_SECRET

(unset)

The service secret of a members-only site. It is sent as X-Seed-Service-Secret on requests to the HM server and IPFS origins only, in place of a session cookie. See the enterprise node. It has no flag.

SEED_APPS_PUBLIC_URL

(unset)

Where clients reach this server, such as https://hyper.media/hm/api/apps when the web host proxies /hm/api/apps here. Reported as publicUrl in /api/health. An app an agent runs here is pointed at it (its appEnvironmentUrl).

SEED_APPS_IPFS_SERVER_URL

HM server URL

The origin for direct /ipfs/* file reads, when it differs from the typed API endpoint.

SEED_APPS_DEFAULT_PROMPT_URL

the Agent Guide on hyper.media

The document a new agent's system prompt embeds, the Agent Guide. Reported as defaultPromptUrl in /api/health; the create-agent dialog embeds it.

SEED_APPS_DOCS_ACCOUNT

(unset)

The account of the knowledge base space. Reads of hm://hyper.media/… go to this account. The system prompt names the knowledge base by it. A link an agent writes to hm://hyper.media/…, in a reply, a document or a comment, is published with it. A client resolves the hyper.media domain to the production docs, so without this setting the links of a dev or staging agent would open another space.

SEED_APPS_DOCS_ACCOUNT_FILE

(unset)

A file that names the knowledge base account, read on every use. Dev points it at the file ./dev hm-sync writes.

SEED_APPS_ACTIVITY_POLL_INTERVAL_MS

5000

How often the activity monitor and the schedule monitor look for work. These are the tasks that fire triggers.

SEED_APPS_ACTIVITY_PAGE_SIZE

50

ActivityFeed page size.

SEED_APPS_ACTIVITY_MAX_PAGES

5

Max pages fetched per poll.

SEED_APPS_SEARXNG_URL

(unset)

Self-hosted SearXNG base URL. It makes web_search work. Without it the tool is still offered, and a call fails. See web research backends.

SEED_APPS_CRAWLER_URL

(unset)

Self-hosted Crawl4AI base URL. With it, a web read can fall back to a real browser for pages that need one.

SEED_APPS_CRAWLER_TOKEN

(unset)

Bearer token for Crawl4AI (required by Crawl4AI >= 0.9).

SEED_APPS_SUBSCRIPTION_AUTH

(off)

Offer provider OAuth sign-in ("Sign in with ChatGPT"). Only 1/true/yes/on enables it.

SEED_APPS_SESSION_TITLE_GENERATION

true

Name untitled sessions with a dedicated model call. Set exactly false to disable. Use the environment variable to turn it off; the flag form does not.

SEED_APPS_EXEC_BACKEND

microsandbox

Code-execution backend for execute. Set empty/off/none to disable. When it is off, or the host cannot run sandboxes, agents are not offered execute.

SEED_APPS_EXEC_IMAGE

python

OCI image used for execution sandboxes.

SEED_APPS_EXEC_TS_IMAGE

oven/bun

OCI image for the ts runtime (needs bun). Set empty to withhold ts.

SEED_APPS_EXEC_CPUS

1

Virtual CPUs per execution sandbox.

SEED_APPS_EXEC_MEMORY_MIB

512

Guest memory per execution sandbox (MiB).

SEED_APPS_EXEC_TIMEOUT_SECS

60

Default per-execution timeout (tool may request up to 300s).

SEED_APPS_EXEC_ALLOW_NETWORK

true

Sandbox internet access. Set false/off/0 to isolate sandboxes.

SEED_APPS_EXEC_DNS

1.1.1.1,8.8.8.8

Comma-separated DNS resolvers used inside execution sandboxes.

SEED_APPS_EXEC_MAX_CONCURRENT

CPU count minus 2, at least 1

Host-wide cap on sandboxes in use at once; a call past the cap waits for a slot.

SEED_APPS_EXEC_ACQUIRE_WAIT_SECS

30

How long a call waits for a sandbox slot under the host-wide cap before failing with a retryable error.

SEED_APPS_EXEC_MEMORY_ROOT_WAIT_SECS

300

How long a call waits for the agent's memory to be free of other sandboxes (another session, a delegated child, a trigger firing of the same agent) before failing with a retryable error. Long by default so those calls queue behind the agent's own running execution instead of failing.

SEED_APPS_EXEC_WARM_POOL

off

Set 1 to keep microVMs alive between calls instead of booting one per call.

SEED_APPS_EXEC_MAX_VMS

3

Warm pool only: pooled VMs retained; extra concurrent calls boot transient VMs rather than wait.

SEED_APPS_EXEC_POOL_IDLE_TTL_SECS

180

Warm pool only: how long a parked VM may sit idle before it is disposed.

SEED_APPS_EXEC_POOL_MAX_AGE_SECS

1800

Warm pool only: maximum age of a pooled VM, enforced between calls.

SEED_APPS_EXEC_CANARY_SECS

0 (off)

How often the exec canary boots a fresh sandbox and runs one command, to prove code execution still works. The hosted production and staging servers set 300. See the code execution backend.

SEED_APPS_MIN_FREE_DISK_MIB

512

Free space the database's file system must have before the queue starts another run; below it runs stay queued and /api/health reports dispatch.paused. 0 disables the check. See the effect outbox.

SEED_APPS_MAX_CONCURRENT_MODEL_RUNS

8

Agent runs that hold a provider stream at once. See the run queue.

SEED_APPS_MAX_CONCURRENT_WORKFLOWS

32

Script runs executed at once. They hold no provider stream.

SEED_APPS_WORKFLOW_WORKER

off

Set 1 to run scripts on a worker thread instead of on the server's main thread. It has no flag.

SEED_APPS_SQLITE_CACHE_MIB

256

SQLite page cache (private memory, counted against the container limit). See persistence.

SEED_APPS_SQLITE_MMAP_MIB

1024

Memory-mapped reads (reclaimable page cache), capped by SQLite's compiled maximum; the value in effect is logged at startup.

SEED_APPS_SQLITE_WAL_LIMIT_MIB

64

Size the WAL file is truncated back to after a checkpoint.

SEED_APPS_RETENTION

on

The retention task: on removes, report only logs what it would remove, off never runs.

SEED_APPS_RETENTION_DURABLE_IDLE_DAYS

14

A session idle this long loses its durable store, which its next turn rebuilds from the log. 0 disables.

SEED_APPS_RETENTION_JOURNAL_DAYS

30

A workflow run finished this long ago has the large payloads in its journal cut to previews. 0 disables.

SEED_APPS_RETENTION_MIB_PER_SEC

2

Disk budget for retention work. 0 is unthrottled.

SEED_APPS_RETENTION_MAX_STORE_MIB

32

Durable stores larger than this are left for the offline pass (a store is dropped in one transaction).

SEED_APPS_RETENTION_INTERVAL_MINS

360

Time between retention passes; the first runs 15 minutes after start.

SEED_APPS_TOOL_OUTPUT_STORE_LIMIT_KIB

128

Longest string (in thousands of characters) a stored tool output keeps; longer ones keep their head and a marker. The model never reads more than 32 KiB of a result either way. 0 disables.

SEED_APPS_LOG_LEVEL

info

Minimum log level (debug, info, warn, error). debug re-enables hot-path lines.

Five more variables are set by the build, not by an operator. The image build writes SEED_APPS_VERSION, SEED_APPS_COMMIT, SEED_APPS_BRANCH and SEED_APPS_DATE, which the version endpoint reports (see deploying). The desktop build puts SEED_APPS_STANDALONE into the bundled binary so that it starts as a server.

Where a row says what the hosted Seed servers set, it describes how those servers are run. That can change, and this repository cannot confirm it.

Command-line flags

A flag wins over the environment variable, and both win over the default:

bun src/main.ts \ --server-hostname 127.0.0.1 \ --server-port 3050 \ --db-path ./data/agents.sqlite \ --data-dir ./data \ --hm-server-url https://hyper.media \ --ipfs-server-url https://hyper.media

Every environment variable in the table has a matching flag, unless its row says it has none. Examples are --searxng-url, --exec-backend, --exec-ts-image, --subscription-auth, --session-title-generation and --max-concurrent-model-runs. The full list is the Flags type in config.ts.

An unknown flag, or a flag with an empty value, stops the server at startup. So a typing mistake fails at once, and the server never runs with a default you did not choose.

See also

Do you like what you are reading? Subscribe to receive updates.

Unsubscribe anytime

Attributes
name
Configuration
summary
This page lists every environment variable and command-line flag the app environment reads, with the default of each and what it changes.