Skip to content

docs: expose Flatpak update schedule #1000

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kubestellar-hive wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: expose Flatpak update schedule #1000

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,60 @@ Two types of flatpak overrides are provided to grant additional permissions to s

These overrides are automatically applied to new user accounts through the `/etc/skel` template.

### Flatpak Update Schedule

Automatic updates are handled by `uupd`, which updates the system image,
Flatpaks, Distrobox containers, and Homebrew together. To keep image updates
enabled while choosing a different Flatpak cadence, disable only uupd's
Flatpak module:

```bash
sudo install -d -m 0755 /etc/uupd
tmp="$(mktemp)"
trap 'rm -f "$tmp"' EXIT
if sudo test -s /etc/uupd/config.json; then
sudo jq '.modules.flatpak.disable = true' /etc/uupd/config.json >"$tmp"
else
printf '%s\n' '{"modules":{"flatpak":{"disable":true}}}' >"$tmp"
fi
sudo install -m 0644 "$tmp" /etc/uupd/config.json
```

This requires `jq` when an existing uupd configuration must be preserved. The
configuration is read on each uupd run, so it applies to the next scheduled
update. Do not edit `/usr/lib/systemd/system/uupd.timer`; image updates replace
files there.

After disabling the module, create local systemd service and timer units under
`/etc/systemd/system` (or user units under `~/.config/systemd/user`) that run
`flatpak update --system --noninteractive` and/or
`flatpak update --user --noninteractive` at the cadence you want. For example,
this system-wide timer runs Flatpak updates every 60 days:

```ini
# /etc/systemd/system/flatpak-system-update.service
[Service]
Type=oneshot
ExecStart=/usr/bin/flatpak update --system --noninteractive
```

```ini
# /etc/systemd/system/flatpak-system-update.timer
[Timer]
OnBootSec=15min
OnUnitActiveSec=60d
Persistent=true

[Install]
WantedBy=timers.target
```

Enable it with `sudo systemctl daemon-reload` and
`sudo systemctl enable --now flatpak-system-update.timer`. Keep custom units
under `/etc` or `~/.config` so they survive image updates. Set
`modules.flatpak.disable` to `false` or remove it to return Flatpak updates to
the normal `uupd.timer` schedule.

## Brewfiles

The `/usr/share/ublue-os/homebrew/` directory contains curated application bundles installable via [bbrew](https://github.com/Valkyrie00/homebrew-bbrew):
Expand Down