Settings is where you tune the agent without editing config files by hand. It is organized into tabs, each covering one area of the system.
General
- System information — agent status, agent version, UI version
- Quick actions — test connection, refresh templates, refresh all, clear cache
- File manager — toggle showing hidden files
- Agent configuration (read-only) — deployments path, API port, CORS status, allowed origins
- Configuration preview — a collapsible view of the effective config
Domain
- Default domain for new deployments
- Subdomain style — Words, Hex, or Short
- Auto subdomain — generate a subdomain for each deployment
- Auto SSL — request certificates automatically
Infrastructure
Settings for the shared services deployments rely on:
- Networks — proxy and database network names
- Nginx — image, container name, config path, reload command, external toggle
- SSL / Certbot — image, email, certs and webroot paths, DNS provider, staging toggle
- Shared database — type (MySQL/MariaDB/PostgreSQL), container, host, port, root user and password
- Shared Redis — container, host, port, password
See Infrastructure for how these pieces fit together.
Security & Monitoring
- Security module — enable, set event retention days and rate threshold
- Auto-blocking — block duration, detection window, and thresholds for 404 floods, auth failures, unique-path scanning, and repeated hits
The dashboards for this data live on the Security page.
Terminal
- Terminal protection — turn the guard on
- Disable terminal — block all shell access
- Blocked command rules — patterns rejected before execution, matched by contains, equals, prefix, suffix, or regex, with optional case sensitivity
These rules govern the System Terminal.
Health Checks
Security and connectivity health indicators for the instance.
Credentials
Manage saved registry logins used to pull private images: add, set a default, test, and delete. Details are in Registries & Credentials.
AI Assistant
- Enabled toggle
- Base URL of an OpenAI-compatible endpoint (defaults to OpenAI)
- Model name
- API key (stored write-only)
See AI Assistant for what it can do.
Settings map to config keys. Each tab writes the same configuration the agent
reads from its config file, so a change here is equivalent to editing the file and reloading.