Configuration

Edit ~/gyblos-seller/gyblos.toml on the host. The supplied image mounts it read-only at /config/gyblos.toml and selects it through GYBLOS_CONFIG. It is read at startup; edits require recreation.

ExampleCopy Anchor Link

version = 1

[node]
network = "devnet"

[discovery]
publish = false

[[offers]]
model = "qwen3:0.6b"
reasoning = ["off"]
engine = { kind = "ollama", url = "http://127.0.0.1:11434/" }
free = { daily_token_cap = 200000, per_buyer_cap = 50000 }

This is a local free offer with publication off. Keep your existing publication choice when editing another setting. To change caps, use Models and offers.

Validate and applyCopy Anchor Link

cd ~/gyblos-seller
docker compose run --rm seller gyblos config validate --config /config/gyblos.toml

Expect OK; correct each reported issue code and key path before applying. Then:

docker compose up -d --force-recreate seller
docker compose exec seller gyblos seller status

config validate checks the schema and environment; doctor checks seller startup compatibility and probes dependencies. A valid file alone does not prove a model can serve. If needed, run docker compose run --rm seller gyblos doctor before recreation.

SettingsCopy Anchor Link

Schema version 1 requires version = 1 and [node] network = "devnet". Unknown keys fail. The file limit is 64 KiB. Counts must be TOML integers, not floats or quoted numbers. Mainnet is refused with MAINNET_UNSUPPORTED. The schema accepts more settings than this seller runtime consumes.

Keep the Docker image's /data home and volume wiring. The native default home is .local/gyblos relative to the working directory; changing it selects different identity state. Do not use a path change to repair a missing identity.

CapacityCopy Anchor Link

All [limits] keys are optional integers, minimum 1, file-only:

Effective max_connections × requests_per_minute must not exceed global_requests_per_minute, including omitted defaults. Doctor prints effective capacity limits. These are separate from offer token quotas.

A request is one answer the buyer asks for. The quote, catalog and receipt calls around it do not count, so 30 per minute is 30 answers per buyer.

OffersCopy Anchor Link

The seller needs at least one [[offers]] entry; at most 32 are allowed. A normalized model can occur only once, including aliases. Every entry must pass plugin compatibility checks; at least one engine must become ready to start, and only ready offers are published.

Exactly one of free or price is required. Free counters reset on restart; they are not persisted. The broader schema accepts price.input_per_mtok and price.output_per_mtok as decimal strings in USDC per million tokens, with price.currency = "USDC". At least one rate must be positive; no signs, exponents or leading zeros, up to four integer and six fractional digits after removing trailing zeros. This tutorial provisions a free-only seller role. Paid offers need separate payment-role setup on devnet; schema acceptance of price does not provision those roles or establish paid readiness.

EnginesCopy Anchor Link

• Ollama: pinned Qwen3 0.6B, reasoning off, literal loopback root URL, no API-key variable. The supplied Docker URL is http://127.0.0.1:11434/. localhost or host.docker.internal can pass schema validation but fail this plugin.
• OpenAI-compatible: reasoning off, explicit context size, HTTPS or literal loopback URL, normally ending in /v1. Disable reasoning upstream. A named key must be set and nonempty.
• Anthropic-compatible: reasoning off, context size and a nonempty named API key. Use the API root without /v1; the provider must support model lookup and Messages.

Provider usage for other models is declared, not independently recounted by the pinned Qwen tokenizer. Remote providers can incur costs and receive buyer data even when your offer is free.

EnvironmentCopy Anchor Link

For seller settings, environment overrides the file, then built-in defaults apply. The general resolver also has programmatic flags, but these are not general CLI options. Compose passes the container's environment; setting a variable only in your host shell does not automatically forward it.

Empty home, bind and external-address variables are ignored. [limits], offers and telemetry have no environment override. After editing seller.env, recreate the container to load the changes.

Secrets and errorsCopy Anchor Link

Use *_env names in TOML, never credential values. Variable names use uppercase letters, digits and underscores and cannot start with a digit. Keep credentials only in the private environment file; never reuse a relay token as a provider key. Inline credential fields and credential-bearing URL queries are rejected, but a credential hidden in a URL path may evade detection. Review before sharing.

Common file codes include TOML_SYNTAX, UNKNOWN_KEY, WRONG_TYPE, INLINE_SECRET, INVALID_CAP, INVALID_LIMIT, RELAY_ONLY_CONFLICT and REASONING_UNSUPPORTED. Warnings such as ENV_SWITCH_NOT_STRICT and REASONING_UNVERIFIED do not fail validation. Startup can additionally reject unsupported settings, engines, reasoning or missing API keys. See troubleshooting.

Related: CLI reference · Models and offers.