{% extends "ui/_layout.html" %} {% block title %}Settings - withcache{% endblock %} {% block subnav %} {% endblock %} {% block intro %}
Effective configuration for this withcache instance. The Catalog source + Logging cards below are form-editable; each write goes through a persistent on-disk override so the daemon reads the same value across restarts.
{% 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

URL withcache fetches catalog.toml bytes from. Env pin (WITHCACHE_CATALOG_URL) wins over on-disk override; override wins over the shipping default. Empty submit clears the override and reverts to the shipping default. The Fetch default catalog button re-parses the currently-effective source and merges its entries into catalog.toml.

Effective URL
{{ catalog_url }}
Env pin
{% if catalog_env_url %} {{ catalog_env_url }} {% else %} (unset) {% endif %}
{% if catalog_fetched_at %}
Last fetched
{{ catalog_fetched_at }}
{% endif %} {% if catalog_last_error %}
{{ catalog_last_error }}
{% endif %} {% if catalog_last_info %}
{{ catalog_last_info }}
{% endif %}
{% if catalog_env_url %} Env pin is set; override is refused while WITHCACHE_CATALOG_URL is present in the environment. {% else %} Empty submit clears the override and reverts to the shipping default. {% endif %}
Logging

Persistent operator override for the uvicorn log level. 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 %}