{% extends "ui/_layout.html" %} {% block title %}Settings - withcache{% endblock %} {% block subnav %} {% endblock %} {% block intro %}
| Setting | Effective | Source | Notes |
|---|---|---|---|
| withcache version | {{ version }} |
package | Container image tag / PyPI release. |
| Project | github.com/safl/withcache | static | Release notes + wire-format docs. |
| 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). |
| 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. |
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 %}| 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.
|