{% extends "ui/_layout.html" %} {% block title %}Settings - withcache{% endblock %} {% block subnav %} {% endblock %} {% block intro %}
Effective configuration for this withcache instance. The Warming card below is form-editable; catalog URL persistence goes through the Catalog page's Set-URL form so the on-disk override file the daemon reads at boot stays the single source of truth.
{% if flash %}
{{ flash }}
{% endif %} {% endblock %} {% block content %}
Identity
Setting Effective Source Notes
withcache version {{ version }} package Container image tag / PyPI release.
Project github.com/safl/withcache static Release notes + wire-format docs.
Storage paths
Setting Effective Source Notes
Data directory {{ data_dir }} CLI --data-dir Holds cache.db, blobs/, catalog.toml, session-secret.
Max cache size {% if max_bytes and max_bytes > 0 %} {{ max_bytes }} bytes {% else %} unlimited {% endif %} CLI --max-bytes Cap on total cached bytes. 0 = unlimited. When full, new fills refuse (delete is manual).
Catalog source
{% if catalog_env_url %} {% endif %}
Setting Effective Source Notes
Catalog URL {{ catalog_url }} env WITHCACHE_CATALOG_URL The URL withcache fetches ``catalog.toml`` bytes from. Env pin wins over on-disk override; override wins over the shipping default.
Env pin {{ catalog_env_url }} env-locked Env var is set; operator ``/admin/catalog_set_url`` overrides are refused while it is.
Warming

Persistent operator overrides for warm-cache knobs. Empty override falls through to the env var; empty env falls through to the shipping default. Set a value here to pin it across restarts.

{% if log_level_error %}
{{ log_level_error }}
{% endif %}
Effective: {{ log_level_effective }} {% if log_level_override %}override {% elif log_level_env %}env {% else %}default{% endif %}
Env: {% if log_level_env %} {{ log_level_env }} {% else %} (unset) {% endif %} · Default: {{ log_level_default }}
Authentication
Setting Effective Source Notes
Admin password {% if auth_enabled %} configured {% else %} open mode {% endif %} env WITHCACHE_ADMIN_PASSWORD When set, POST admin routes + UI gate on a session cookie. When unset, the control plane is open (LAN-only deploy). Byte-serving stays open regardless so bty can pull from a sibling container.
Session secret {% if session_secret_from_env %} from env {% else %} <data-dir>/session-secret {% endif %} env WITHCACHE_SESSION_SECRET HMAC key signing the withcache-token cookie. Persisted to disk when env unset so cookies survive restarts.
{% endblock %}