{% extends "base.html" %} {% block title %}{{ agent_name }} — Settings{% endblock %} {% block content %}

Settings

{% if current_user.is_admin %}
{% else %}
{% endif %} {% if current_user.is_admin %}

Agent Control

Status: {% if is_paused %}Paused{% else %}Running{% endif %}  

Trusted Proxy IPs

If {{ agent_name }} is accessed through a reverse proxy (e.g. Zoraxy, nginx), enter the proxy's IP address here. This lets {{ agent_name }} log the real visitor IP instead of the proxy's internal IP.

Leave as 127.0.0.1 if the proxy runs on the same machine. Use a LAN IP (e.g. 192.168.1.50) if the proxy is on a different server. Subnet notation is supported (e.g. 192.168.1.0/24). Separate multiple entries with commas.

Restart required after saving. The setting is stored immediately, but only takes effect after a server restart.
On Docker: run docker compose restart on the server. On local: stop and restart uvicorn.

Runtime Limits

Override the defaults from .env. Changes take effect immediately — no restart needed. Individual agents can further override Max tool calls on their own settings page.

Default Chat Models

Pre-select a model in the chat picker. Falls back to DEFAULT_CHAT_MODEL in .env, then the first available model. Changes take effect immediately — no restart needed.

Audit Log

Automatic rotation deletes old entries daily at 03:00. Set to Keep forever to disable rotation.

Manual clear — immediately deletes entries:

API Key

Protect the REST API for external access (scripts, home automations, other services). The web UI always works without a key - any browser that loads the app gets a session cookie automatically. The key is only needed for external programmatic access and Swagger. The raw key is shown once at generation time - copy it to your external tool.

Loading...

External requests: use header X-API-Key: <key> or Authorization: Bearer <key>.
The Swagger UI at /docs has an Authorize button where you can enter the key. The web UI itself never needs the key - it uses a session cookie set automatically on page load.

Users Base Folder

Absolute path on the server where each user's personal folder will be provisioned. Non-admin users can only access their own subfolder ({base}/{username}/). If unset, non-admin users have no filesystem access.

Provider API Keys

Global API keys used by all agents and users. Changes take effect immediately — no restart required. If a user sets their own key, it takes precedence over these.

Anthropic
Loading...
OpenRouter
Loading...
OpenAI
Loading...
{% else %}

My API Keys

Set your own API keys. If left blank, the system defaults are used.

Anthropic API Key
Loading...
OpenRouter API Key
Loading...
OpenAI API Key
Loading...
{% endif %}
{% block extra_scripts %} {% endblock %} {% endblock %}