Files
Chronos/deploy/unraid/chronos.xml
T
Alby96 3812773999 feat(P3): videos API, server videos folder and the /videos volume
The server side of the videos library (owner review 1, R9): one list of every
render, a delete into the archive's trash that is always a dry run first and
must give the plan's fingerprint back, and a hash-verified copy into a videos
folder as one video-copy job, so the panel and the desktop manage renders
without editing anything.

- /api/v1/videos: list (filters, sort, paging), get, delete (Delete, audited
  videos_deleted) and copy (Edit, audited videos_copied; 409
  videos_folder_unset, 422 videos_folder_invalid, 507 videos_no_space).
- The "videos" capability; format 3 comes from ProjectSettings.CurrentVersion.
- Trash routes accept videos-<id>-<ticks> entries; restore goes through the
  videos library (hash re-check, same render id).
- Render DTOs carry sha256 and kind; sent renders and node results record
  the verified hash and the kind.
- VideosPath setting (CHRONOS_VIDEOS_PATH locks it): absolute, outside the
  archive and the data folder; video-copy gets a priority level.
- Docker: /videos volume in compose with CHRONOS_VIDEOS_PATH, folder made in
  the image (not a VOLUME), entrypoint checks it; Unraid template rows.
- .webm, .m4v and .apng served with their media types for the panel player.

Refs #21
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 02:08:01 +01:00

59 lines
11 KiB
XML

<?xml version="1.0"?>
<Container version="2">
<Name>chronos-server</Name>
<Repository>gitea.encke-hake.ts.net/balbosoft/chronos-server:latest</Repository>
<Registry>https://gitea.encke-hake.ts.net/BalboSoft/Chronos</Registry>
<Network>bridge</Network>
<MyIP/>
<Shell>sh</Shell>
<Privileged>false</Privileged>
<Support>https://gitea.encke-hake.ts.net/BalboSoft/Chronos/issues</Support>
<Project>https://gitea.encke-hake.ts.net/BalboSoft/Chronos</Project>
<Overview>Chronos Server keeps a shared, verified archive of time-lapse photo sequences and renders them; pair it with the official PostgreSQL 17 container. Clients connect to the Client address the admin panel shows (Settings, Network and TLS); LAN discovery needs network type Host.</Overview>
<Category>MediaServer:Photos Tools:</Category>
<WebUI>http://[IP]:[PORT:8080]/admin</WebUI>
<TemplateURL>https://gitea.encke-hake.ts.net/BalboSoft/Chronos/raw/branch/main/deploy/unraid/chronos.xml</TemplateURL>
<Icon>https://gitea.encke-hake.ts.net/BalboSoft/Chronos/raw/branch/main/branding/chronos-server.svg</Icon>
<ExtraParams>--restart unless-stopped</ExtraParams>
<PostArgs/>
<CPUset/>
<DateInstalled/>
<DonateText/>
<DonateLink/>
<Requires>A PostgreSQL 16 or 17 container (official "postgres" template) with a database and user for Chronos.</Requires>
<Config Name="HTTP port" Target="8080" Default="8080" Mode="tcp" Description="Admin panel and API over HTTP; when you change it, enter the same port in Public HTTP port. Network type Host ignores this mapping: the server then listens on 8080 itself." Type="Port" Display="always" Required="true" Mask="false">8080</Config>
<Config Name="HTTPS port" Target="8443" Default="8443" Mode="tcp" Description="API over TLS for Chronos clients, which connect to https://[server IP]:[this port]; when you change it, enter the same port in Public HTTPS port. Network type Host ignores this mapping: the server then listens on 8443 itself." Type="Port" Display="always" Required="true" Mask="false">8443</Config>
<Config Name="Public HTTP port" Target="CHRONOS_PUBLIC_HTTP_PORT" Default="" Mode="" Description="The HTTP port above, when it is not 8080; LAN discovery announces it. Set here, the admin panel can no longer change it (empty: 8080, changeable in the admin panel)." Type="Variable" Display="always" Required="false" Mask="false"/>
<Config Name="Public HTTPS port" Target="CHRONOS_PUBLIC_HTTPS_PORT" Default="" Mode="" Description="The HTTPS port above, when it is not 8443: the port of the client address, the admin panel's redirect and LAN discovery. Set here, the admin panel can no longer change it (empty: 8443, changeable in the admin panel)." Type="Variable" Display="always" Required="false" Mask="false"/>
<Config Name="Archive" Target="/archive" Default="/mnt/user/Timelapse" Mode="rw" Description="Originals, sidecars, proxies and renders." Type="Path" Display="always" Required="true" Mask="false">/mnt/user/Timelapse</Config>
<Config Name="Array view" Target="/space" Default="/mnt/user0/Timelapse" Mode="ro" Description="Optional: the same share seen on the array only (/mnt/user0/&lt;share&gt;), to show the array's free space." Type="Path" Display="always" Required="false" Mask="false">/mnt/user0/Timelapse</Config>
<Config Name="Videos" Target="/videos" Default="" Mode="rw" Description="Optional: the folder Copy to videos folder puts copies of renders in, each checked by hash (for example /mnt/user/Videos/Chronos; not inside the Archive). Set Videos path below to /videos too. Chronos never deletes what it copied there." Type="Path" Display="always" Required="false" Mask="false"/>
<Config Name="App data" Target="/data" Default="/mnt/user/appdata/chronos" Mode="rw" Description="Settings, TLS certificate, uploads in progress and logs." Type="Path" Display="always" Required="true" Mask="false">/mnt/user/appdata/chronos</Config>
<Config Name="Admin user" Target="CHRONOS_ADMIN_USER" Default="admin" Mode="" Description="Created at first start when no administrator exists." Type="Variable" Display="always" Required="true" Mask="false">admin</Config>
<Config Name="Admin password" Target="CHRONOS_ADMIN_PASSWORD" Default="" Mode="" Description="Initial password; a change is required at first sign-in." Type="Variable" Display="always" Required="true" Mask="true"/>
<Config Name="Database host" Target="CHRONOS_DB_HOST" Default="" Mode="" Description="IP address of the Unraid server (PostgreSQL's port mapped), or the PostgreSQL container's name when both containers are on the same custom network; names do not resolve on bridge." Type="Variable" Display="always" Required="true" Mask="false"/>
<Config Name="Database port" Target="CHRONOS_DB_PORT" Default="5432" Mode="" Description="PostgreSQL port." Type="Variable" Display="advanced" Required="true" Mask="false">5432</Config>
<Config Name="Database name" Target="CHRONOS_DB_NAME" Default="chronos" Mode="" Description="Database owned by the Chronos user." Type="Variable" Display="always" Required="true" Mask="false">chronos</Config>
<Config Name="Database user" Target="CHRONOS_DB_USER" Default="chronos" Mode="" Description="PostgreSQL role." Type="Variable" Display="always" Required="true" Mask="false">chronos</Config>
<Config Name="Database password" Target="CHRONOS_DB_PASSWORD" Default="" Mode="" Description="PostgreSQL password." Type="Variable" Display="always" Required="true" Mask="true"/>
<Config Name="Database TLS" Target="CHRONOS_DB_SSLMODE" Default="prefer" Mode="" Description="disable, prefer, require or verify-full." Type="Variable" Display="advanced" Required="false" Mask="false">prefer</Config>
<Config Name="TLS mode" Target="CHRONOS_TLS_MODE" Default="auto" Mode="" Description="auto (self-signed), pem (own certificate) or proxy (behind a reverse proxy)." Type="Variable" Display="advanced" Required="false" Mask="false">auto</Config>
<Config Name="Trusted proxies" Target="CHRONOS_TRUSTED_PROXIES" Default="" Mode="" Description="TLS mode proxy: the fixed IP address of your reverse proxy container (put both containers on a custom Docker network and give the proxy a Fixed IP address there). Never a range, the network gateway or the default bridge 172.17.0.0/16: other containers and connections Docker relays would count as the proxy. Only loopback is trusted otherwise." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Space path" Target="CHRONOS_SPACE_PATH" Default="/space" Mode="" Description="Folder whose free space the admin panel shows: the Array view above (empty: the archive's, which on a cached share is the cache's)." Type="Variable" Display="advanced" Required="false" Mask="false">/space</Config>
<Config Name="Videos path" Target="CHRONOS_VIDEOS_PATH" Default="" Mode="" Description="/videos when the Videos folder above is mapped: copying to the videos folder is on and the admin panel can no longer change the folder (empty: copying off unless a folder is set in the admin panel)." Type="Variable" Display="always" Required="false" Mask="false"/>
<Config Name="Server name" Target="CHRONOS_SERVER_NAME" Default="Chronos Server" Mode="" Description="Name shown to clients." Type="Variable" Display="advanced" Required="false" Mask="false">Chronos Server</Config>
<Config Name="Parallelism" Target="CHRONOS_PARALLELISM" Default="" Mode="" Description="Jobs run one at a time: photos the running job processes at once (empty: half the cores, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Priority queue" Target="CHRONOS_PRIORITY_QUEUE" Default="" Mode="" Description="true: a job of a higher kind pauses the running one, which resumes afterwards (empty: set it in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Log level" Target="CHRONOS_LOG_LEVEL" Default="" Mode="" Description="Trace, Debug, Information, Warning, Error, Critical or None: sets and locks the level of the log files and, unless Console log level is set, of the container's log; the admin panel can then no longer change either (empty: Information, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Console log level" Target="CHRONOS_LOG_CONSOLE_LEVEL" Default="" Mode="" Description="Level of the container's log alone (empty: the Log level's)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Log retention" Target="CHRONOS_LOG_RETENTION_DAYS" Default="" Mode="" Description="Days the log files in /data/logs are kept (empty: 14, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Log file size" Target="CHRONOS_LOG_MAX_FILE_MB" Default="" Mode="" Description="MB at which a log file continues in a numbered one; 0: no limit (empty: 50, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Logs total size" Target="CHRONOS_LOG_MAX_TOTAL_MB" Default="" Mode="" Description="MB all log files may take, the oldest deleted beyond it; 0: no limit (empty: 1024, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Log rotation" Target="CHRONOS_LOG_ROTATION" Default="" Mode="" Description="daily or hourly: a new log file every day or every hour, UTC (empty: daily, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Audit retention" Target="CHRONOS_AUDIT_RETENTION_DAYS" Default="" Mode="" Description="Days the Audit log clean-up schedule keeps audit entries; 0: forever (empty: forever, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="Diagnostics log size" Target="CHRONOS_DIAGNOSTICS_LOG_MB" Default="" Mode="" Description="MB from the end of each log file in the diagnostics zip (empty: 4, changeable in the admin panel)." Type="Variable" Display="advanced" Required="false" Mask="false"/>
<Config Name="PUID" Target="PUID" Default="99" Mode="" Description="User id that owns files." Type="Variable" Display="advanced" Required="true" Mask="false">99</Config>
<Config Name="PGID" Target="PGID" Default="100" Mode="" Description="Group id that owns files." Type="Variable" Display="advanced" Required="true" Mask="false">100</Config>
<Config Name="Time zone" Target="TZ" Default="Europe/Rome" Mode="" Description="Local time of the scheduled jobs and of the folders of photos without a capture time; logs stay in UTC." Type="Variable" Display="advanced" Required="false" Mask="false">Europe/Rome</Config>
</Container>