Files
Chronos/deploy/unraid/chronos.xml
T
Alby96 75daab7275 feat(server): scheduled jobs on the server and a Scheduled tab in the admin panel
Owner review 2, R10: nothing may run out of sight, so every timer the server
ran becomes a system schedule the admin panel shows and manages, and
administrators create their own.

- SchedulerHost runs the shared Scheduler on the job engine (started after
  JobEngineHost, stopped before it); ServerScheduleHost gives it the
  container's time zone (UTC with a warning when TZ is unknown), the archive
  refreshed from archive.json at every run (what ArchivePolling did), the
  clean-up steps and the system schedules: archive-scan every 10 minutes
  (no catch-up, also run once at start like the polling), upload-cleanup
  every 30 minutes, index-backup at 03:00 (SQLite only), housekeeping (job
  history) at 04:00 and audit-cleanup at 04:30.
- ArchivePolling and DatabaseBackupService are gone; UploadMaintenance only
  recovers commits at start, its sweep is the "uploads" clean-up step.
- /api/v1/schedules (ManageArchive, audited): list with actions and time
  zone, create, PUT/PATCH, delete (409 schedule_system), run now (409
  schedule_pending), reset (409 schedule_no_defaults), runs paged by cursor;
  invalid fields are 400 invalid_schedule naming the field.
- CHRONOS_AUDIT_RETENTION_DAYS (AuditRetentionDays, default 365) seeds the
  audit clean-up; set by the environment it is applied at every start and
  locked. Job history leaves Settings: it is the housekeeping schedule's age
  limit, and the setting is what a reset restores.
- Admin panel: Jobs has Queue and Scheduled tabs; schedules with when (in
  the panel's language and the server's zone), next run, last result, a
  switch, Run now, Edit, Delete or Reset, their runs linking to the jobs, and
  a side panel for the action, recurrence and parameters; job rows a
  schedule queued carry a Scheduled pill. Strings in en and it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
(cherry picked from commit 808ce94ae29e3bf4522cb4d40dfd76d4f8529c64)
2026-10-27 02:25:01 +01:00

56 lines
8.9 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.</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." 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. When you change it, enter the same port in Public HTTPS port." Type="Port" Display="always" Required="true" Mask="false">8443</Config>
<Config Name="Public HTTPS port" Target="CHRONOS_PUBLIC_HTTPS_PORT" Default="" Mode="" Description="The HTTPS port above, when it is not 8443; the admin panel redirects there." 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="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="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="Information" Mode="" Description="Level of the log files and, unless Console log level is set, of the container's log: Trace, Debug, Information, Warning, Error, Critical or None." Type="Variable" Display="advanced" Required="false" Mask="false">Information</Config>
<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 audit entries are kept; 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>