Owner review 4 and owner review 1 phase 6. - Work board in Videos (desktop and admin panel): Published and Workspace lanes (#29). - Anonymous usage counts removed: Chronos sends nothing about its use (#30). - The archive's whole folder tree is created inside any archive root, on the server and the desktop (#31). - Video cards start with the preset; sizes keep number and unit together (#28). - Deploy guide docs/deploy (Docker, Unraid, desktop), BRIEF §24, original documentation in docs/reference/original (#22). Closes #22 #28 #29 #30 #31 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
8.0 KiB
Chronos Server on Unraid
Chronos Server from the template deploy/unraid/chronos.xml, next to the official PostgreSQL template. Every variable
and behaviour is described in docker.md; this page covers what is particular to Unraid.
Install
-
PostgreSQL. Install the official postgresql17 template from Community Applications (16 works too). Create a role and a database for Chronos:
docker exec -it postgresql17 psql -U postgres \ -c "CREATE ROLE chronos LOGIN PASSWORD '<a long random password>'" \ -c "CREATE DATABASE chronos OWNER chronos" -
The template. Unraid's Template repositories read GitHub and GitLab addresses, not Gitea's, so save the template as a user template from the Unraid terminal:
wget -O /boot/config/plugins/dockerMan/templates-user/my-chronos-server.xml \ https://gitea.encke-hake.ts.net/BalboSoft/Chronos/raw/branch/main/deploy/unraid/chronos.xmlWhile the
BalboSoftorganisation is private, the download and the image pull need an account: download the file in a signed-in browser and copy it there, and rundocker login gitea.encke-hake.ts.netonce in the terminal. -
The container. Docker › Add container › Template › chronos-server. Fill in at least:
Field Value Admin password The first password of admin; a change is required at the first sign-inDatabase host The Unraid server's IP address (the PostgreSQL template publishes 5432). A container name resolves only when both containers are on the same custom Docker network, never on the default bridge Database password The role's password from step 1 Archive The share of your time-lapses, default /mnt/user/TimelapseArray view The same share under /mnt/user0, default/mnt/user0/Timelapse(see free space)Leave the network type on Bridge unless you need LAN discovery (below).
-
First sign-in. Open the WebUI (
http://[IP]:[HTTP port]/admin), sign in asadminand choose a new password. -
Clients. In Settings › Network and TLS copy the Client address into Chronos and the Uploader and compare the Fingerprint at their first connection.
Template fields
| Field | Container side | Default | Notes |
|---|---|---|---|
| HTTP port | port 8080 | 8080 | Admin panel and API over HTTP; the WebUI link follows it |
| HTTPS port | port 8443 | 8443 | API over TLS for Chronos and the Uploader |
| Public HTTP port | CHRONOS_PUBLIC_HTTP_PORT |
empty | The HTTP port above when it is not 8080 |
| Public HTTPS port | CHRONOS_PUBLIC_HTTPS_PORT |
empty | The HTTPS port above when it is not 8443: the port of the client address |
| Archive | /archive |
/mnt/user/Timelapse |
Originals, sidecars, proxies, renders |
| Array view | /space (read-only) |
/mnt/user0/Timelapse |
Optional; with Space path |
| Videos | /videos |
empty | Optional folder for Copy to videos folder, not inside the archive (for example /mnt/user/Videos/Chronos); with Videos path |
| App data | /data |
/mnt/user/appdata/chronos |
Settings, TLS certificate, uploads in progress, logs |
| Admin user / Admin password | CHRONOS_ADMIN_USER / CHRONOS_ADMIN_PASSWORD |
admin / empty |
Read only while no administrator exists |
| Database host, port, name, user, password, TLS | CHRONOS_DB_* |
—, 5432, chronos, chronos, —, prefer |
Port and TLS are advanced |
| Videos path | CHRONOS_VIDEOS_PATH |
empty | /videos once Videos is mapped; empty turns copying off unless a folder is set in the admin panel |
| TLS mode, Trusted proxies, Space path, Server name, Parallelism, Priority queue, the log fields, Audit retention, Diagnostics log size, PUID (99), PGID (100), Time zone | the variables of docker.md | as there | Advanced. Empty means the admin panel chooses; a value locks the setting there |
The template has no field for CHRONOS_TLS_CERT, CHRONOS_TLS_KEY, CHRONOS_LANG, CHRONOS_DISCOVERY,
CHRONOS_HTTP_PORT or CHRONOS_HTTPS_PORT: add them with Add another Path, Port, Variable… › Variable when
needed.
Ports other than 8080 and 8443
When another container already uses 8080 or 8443 on the Unraid host, change only the host side and tell Chronos which ports clients use. The owner's setup:
| Field | Value |
|---|---|
| HTTP port | 8087 (container 8080) |
| HTTPS port | 8444 (container 8443) |
| Public HTTP port | 8087 |
| Public HTTPS port | 8444 |
Clients then connect to https://<Unraid IP>:8444, the client address the admin panel shows, and the WebUI opens
http://<Unraid IP>:8087/admin. The admin panel's HTTP port and HTTPS port stay 8080 and 8443, read-only: they are
the container's ports, not the ones clients use. The public ports may be left empty in the template and entered in the
admin panel's Settings › Network and TLS instead; set in the template, they are locked there.
Free space of the array
A user share (/mnt/user/<share>) reports the free space of its primary storage, often the cache, while the mover
sends the photos to the array. The Array view maps the same share as seen on the array alone (/mnt/user0/<share>)
read-only to /space, and Space path /space makes the admin panel show that volume's free space. When the archive's
own volume differs it shows apart as Write volume. Change Array view together with Archive, or remove it and clear
Space path. Uploads still check the archive's own volume.
Network type
- Bridge (default): the port mappings apply, LAN discovery stays inside Docker, clients type the client address.
- Host: clients find the server by themselves, the mappings are ignored and the server listens on the host's 8080
and 8443 itself; it does not start when another service uses either. Add the variable
CHRONOS_HTTP_PORTorCHRONOS_HTTPS_PORTwith a free port first and leave the public ports empty. - A custom Docker network shared with the PostgreSQL container lets Database host be the container's name.
Upgrading
- Back up
/mnt/user/appdata/chronosand the database (below). - Docker › the container › Check for updates / Update, or Force update. The database is migrated at start; jobs resume from their last checkpoint.
A container made from an earlier template, or one on :nightly: edit it, set Repository to
gitea.encke-hake.ts.net/balbosoft/chronos-server:latest, and when its host ports are not 8080/8443 add the public
ports (Public HTTP port 8087 and Public HTTPS port 8444 in the owner's case), or enter them in the admin panel. An
earlier template's Log level Information now locks both log levels: clear it to choose them in the admin panel.
Going back to an older tag needs the database backup taken before the upgrade (migrations only go forward).
Backup
- App data and PostgreSQL: the Appdata Backup plugin, with both containers stopped during the backup, covers
/mnt/user/appdata/chronosand the PostgreSQL template's data folder. Or dump the database yourself:docker exec postgresql17 pg_dump -U chronos -d chronos -Fc > /mnt/user/backups/chronos-$(date +%F).dump. - Archive: the share itself, with your usual share backup; include the
.chronosfolders. - Restore: put the app data and the archive back, recreate the container from the template with the same paths,
restore the dump (
docker exec -i postgresql17 pg_restore -U chronos -d chronos --clean --if-exists < <dump>), then start Chronos. See docker.md › Backup and restore for what each part holds.
Troubleshooting
See docker.md › Troubleshooting. The two Unraid classics:
- The Uploader cannot connect: the host ports differ from 8080/8443 and the public ports are empty, so the client address names ports the host does not publish. Set Public HTTP port and Public HTTPS port.
- The free space shown is the cache's: map Array view and set Space path
/space.