Skip to main content
zmeel configure lets you update specific sections of your Zmeel config interactively, without re-running the full onboarding wizard. Each section has its own set of prompts. After you answer them, the config file is updated immediately.
You must run zmeel onboard at least once before using zmeel configure. If no config file exists, configure exits with an error.

​
Usage

zmeel configure
zmeel configure --section <section>
Without --section, you are prompted to pick a section from a menu. With --section, the named section opens directly and the command exits when that section is saved — no loop.

​
Options

​
-s, --section
string
The configuration section to update. When provided, the command opens that section directly and exits after saving. Accepted values: llm, database, logging, server, storage, secrets.
​
-c, --config
string
Path to the config file. Defaults to ~/.zmeel/instances/default/config.json.
​
-d, --data-dir
string
Data directory root. Isolates all state from ~/.zmeel.

​
Sections

​
llm
section
LLM provider and API key. Supported providers: claude (Anthropic) and openai. You can clear the LLM config to remove an existing provider.
​
database
section
Database connection. Choose between embedded PostgreSQL (no external dependency) or an external PostgreSQL connection string.
​
logging
section
Log level and output mode. Controls where Zmeel writes its server logs.
​
server
section
Deployment mode, port, public URL, and allowed hostnames. Also configures the auth base URL mode — use explicit when your instance is behind a reverse proxy with a custom domain.
​
storage
section
Storage provider. Choose local_disk for single-machine deployments or s3 for S3-compatible object storage. local_disk is the default.
​
secrets
section
Secrets encryption settings. Controls the provider and key file path used to encrypt agent credentials and other sensitive values at rest.

​
Examples

# Update your LLM provider and API key
zmeel configure --section llm

# Change the server port or deployment mode
zmeel configure --section server

# Switch storage from local disk to S3
zmeel configure --section storage

# Open the interactive section picker
zmeel configure

​
Config file location

Changes are written to ~/.zmeel/instances/default/config.json. To manage a different instance, pass --data-dir or --config: 
zmeel configure --section llm --data-dir ./tmp/zmeel-dev
After changing configuration, run zmeel doctor to verify that the updated settings are valid and that all services can connect.