fix: address the rc.14 review

Settings no longer makes a folder an archive on its own: a typed or
picked folder without archive.json is made one only after a
confirmation naming it, and Settings > Import keeps this PC's archive
folder and never creates one. A half-typed path or another PC's drive
letter could otherwise get .chronos and sidecars written unasked.

The server's structure check creates nothing in a root that lost its
archive.json (an unmounted disk's empty mount point) and reports it
unavailable; /health re-checks when its last check is over 10 s old,
so a fix on the host shows without a dashboard read.

The admin board reads the server newest first with Order off, counts
Published over the server's total, and a Shift range runs along the
lane picked in. Admin sizes keep number and unit together. A sent
workspace render whose file left exports/ is no longer listed as
missing. Desktop Board cards put their actions under the text while
the player is open. Start-up range errors name the CHRONOS_* variable;
the deploy guide documents the parallelism clamp and the log rule.

Refs #29 #31

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-11-06 17:52:44 +01:00
1 parent 159a8e6939
commit 2c15ee0e09
25 files changed
+336 -53

No files matched your search

+7 -3
View File
@@ -61,14 +61,18 @@ docker compose up -d
- At every start the server lays out the archive's folder tree inside `/archive` (`.chronos/` with `locks`, `journal`,
`staging`, `trash`, `trash/photos`, `trash/videos`), making only the missing folders and touching nothing that
exists. A folder it cannot make does not stop the start: the log warns, the dashboard shows *Archive incomplete*
(the folder and reason in its tooltip) and `/health` reports archive "incomplete" until it can be made.
(the folder and reason in its tooltip) and `/health` reports archive "incomplete" until it can be made. Both check
again by themselves (the dashboard at each read, `/health` when its last check is over 10 seconds old), so a fix on
the host needs no restart. A root without its `.chronos/archive.json` (an unmounted disk leaves an empty mount
point) gets no folders: the dashboard shows *Archive incomplete* and `/health` reports archive "missing".
## Environment variables
Every server setting comes from, in order: its default, `/data/server.json`, then the environment. **A variable that is
set fixes its setting:** the admin panel shows the field read-only and its tooltip names the variable. Leave a
variable unset to choose the value in the admin panel while the server runs. A value out of range stops the start
with a message naming the variable.
with a message naming the variable, except `CHRONOS_PARALLELISM`, which is held to 1–64. The logs' total
(`CHRONOS_LOG_MAX_TOTAL_MB`) may not be below the log file size (`CHRONOS_LOG_MAX_FILE_MB`), unless it is 0.
| Variable | Default | Meaning |
|---|---|---|
@@ -220,7 +224,7 @@ a newer archive, run Archive › *Scan* so the index catches up with what the ar
| *Not a Chronos server* | Another service answers on that host port (on the owner's host 8443 is another service). Use the client address with the right public HTTPS port |
| The free space shown is the cache's (Unraid) or too small | A cached share reports its primary storage. Map the share's array view read-only to `/space` and set `CHRONOS_SPACE_PATH=/space` ([unraid.md](unraid.md#free-space-of-the-array)) |
| The container restarts at once, log: *… is not writable by PUID:PGID* | Give that user write access to the archive (or the named `.chronos` folder) on the host, or set `PUID`/`PGID` to its owner |
| Dashboard: *Archive incomplete*; `/health`: archive "incomplete" | A folder of the archive's tree cannot be made (share unavailable, permission denied, read-only, a file in the way; the tooltip names it). Fix it on the host; the next dashboard read checks again, no restart needed |
| Dashboard: *Archive incomplete*; `/health`: archive "incomplete" | A folder of the archive's tree cannot be made (share unavailable, permission denied, read-only, a file in the way; the tooltip names it). Fix it on the host; the next dashboard read, or `/health` within 10 seconds, checks again, no restart needed |
| Log: *Database not reachable yet … retry* | PostgreSQL is starting, or `CHRONOS_DB_HOST` is wrong. Container names resolve only on a shared user-defined network; on Unraid's default bridge use the host's IP |
| A field in the admin panel is read-only | A variable sets it; its tooltip names it. Remove the variable to change it in the panel |
| The client asks to trust a new fingerprint | `/data` was replaced or the self-signed certificate was renewed. Compare with the admin panel before accepting |