Auto-Update
Auto-Update lets Thymis automatically keep your devices up to date without manual intervention. On the configured schedule it:
- Runs
nix flake updateto pull in the latest versions of all Nix inputs (nixpkgs, Thymis modules, external repositories). - Commits the updated
flake.lockto the project repository. - Deploys the new configuration to every connected device.
The Auto-Update task shows as Completed only once all device deploys have finished.
Enabling Auto-Update
- In the sidebar, click Auto-Update.
- Toggle Enable Auto-Update on.
- Configure the schedule (see below).
- Click Save.
Configuring the Schedule
Frequency
| Frequency | Description |
|---|---|
| Daily | Fires on the selected days of the week at the configured time. Select one or more days. |
| Weekly | Fires once per week on a single selected day at the configured time. |
| Monthly | Fires on a specific day of the month (1–28) at the configured time. |
| Monthly (by weekday) | Fires on the nth occurrence of a specific weekday in the month (e.g. “first Monday”, “last Friday”). |
Default schedule
The default schedule fires daily on Monday through Thursday at 03:00 UTC. This avoids weekend fire times while leaving Friday–Sunday free for manual work.
Time of Day
You can set the Time of Day (UTC) for all frequencies. The controller always interprets this time as UTC regardless of the timezone of the devices.
Daily: Days of the Week
When Daily is selected, choose one or more days to fire on using the day chip-buttons. At least one day must be selected.
Weekly: Day of the Week
When Weekly is selected, choose exactly one day from the dropdown. The update fires once every week on that day.
Monthly: Day of Month
When Monthly is selected, choose a day between 1 and 28. Days 29–31 are not available to avoid invalid dates in short months.
Monthly (by weekday): Occurrence and Weekday
When Monthly (by weekday) is selected, two dropdowns appear:
- Which occurrence — First, Second, Third, Fourth, Fifth, or Last.
- Day of the week — Monday through Sunday.
If the selected occurrence does not exist in a given month (e.g. “fifth Monday” in a month with only four Mondays), that month is skipped and the update fires in the next month that has the occurrence.
Running an Update Immediately
Click Run Now on the Auto-Update page to trigger an auto-update immediately, regardless of the configured schedule.
Uncommitted Work
Only committed changes are updated and deployed. Before running, Thymis temporarily sets aside any uncommitted changes in the project repository (git stash), performs the update and deploy using the committed state, then restores your work-in-progress (git stash pop).
Your uncommitted changes are not affected and will be waiting for you exactly as you left them.