{% 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). |
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.
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 %}| 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.
|