From 4350b1657cbb2dd1780e95dbed26c9f6de7f112b Mon Sep 17 00:00:00 2001 From: sneak Date: Thu, 15 Oct 2026 06:07:56 +0000 Subject: [PATCH] Tell upaas operators to set the cache size limit (closes #251) "Running under upaas" listed PIXA_CACHE_MAX_BYTES as optional. Under upaas the volume is a directory on the host's filesystem. The default, 75% of the sum of that filesystem's free space and what the cache holds, and at least 500 MiB, lets one pixa take three quarters or more of the space the host and every other app have left, and all of it when that is 500 MiB or less. The section now says to set it and why. The default is unchanged. Model: opus-5-5 --- README.md | 8 ++++++-- TODO.md | 7 +++++++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5fb6a49..67a9c02 100644 --- a/README.md +++ b/README.md @@ -123,8 +123,12 @@ What the [upaas](https://git.eeqj.de/sneak/upaas) app for pixa needs: comma-separated; default none. Every image on a listed host is served to anyone without a signature, so list only hosts you control, where nobody else can put images. - - `PIXA_CACHE_MAX_BYTES`: disk cache limit in bytes; `0` disables it; - default 75% of (free space + what the cache holds) + - `PIXA_CACHE_MAX_BYTES`: disk cache limit in bytes; `0` disables it. Set + it: the volume is a directory on the host's filesystem, shared with the + host and every other app. The default is 75% of the sum of that + filesystem's free space and what the cache holds, and at least 500 MiB, so + the cache can grow to three quarters or more of the space they all have + left, and to all of it when that is 500 MiB or less. - the rest are in the table under Configuration below - **Health check:** the image's `HEALTHCHECK` requests `/.well-known/healthcheck.json`. upaas reads the container's health 60 seconds diff --git a/TODO.md b/TODO.md index 7793ef4..abf73c5 100644 --- a/TODO.md +++ b/TODO.md @@ -30,6 +30,13 @@ P2: security: per-origin rate limiting # Completed Steps +- 2026-10-15 "Running under upaas" in `README.md` tells the operator to set + `PIXA_CACHE_MAX_BYTES` (closes #251): it listed the variable as optional, but + under upaas the volume is a directory on the host's filesystem. The default, + 75% of the sum of that filesystem's free space and what the cache holds, and + at least 500 MiB, let one pixa take three quarters or more of the space the + host and every other app had left, and all of it when that was 500 MiB or + less. The section now says so. The default is unchanged. - 2026-10-15 a `:` in the source path or query no longer moves where the path ends and the query begins (closes #247): the signed data and the cache key joined host, path and query with `:` and no escaping, so a URL signed for