paru -Syu
Maze is a rolling release: there are no version upgrades to plan for, just a steady stream of updates.
Use paru -Syu rather than sudo pacman -Syu: a few default desktop apps
(Joplin, Session, Upscayl, ONLYOFFICE, Claude Code) come from the AUR, and
pacman alone never updates them. paru asks for your password itself when it
needs it — do not run it with sudo.
If something is wrong, the system tells you before you shut down — a desktop notification, a warning on every terminal login, and a shutdown inhibitor (see Diagnostics) — and tells you what the problem is. That ordering matters: a boot problem you learn about while you are still booted is an inconvenience; the same problem discovered at the next power-on is an outage.
In rough order of effort:
sudo maze-doctor, see DiagnosticsMaze's own packages come from the [mazelinux] repository
(https://mazerepo.berkkucukk.com.tr/packages). Every package is GPG-signed and
pacman refuses unsigned ones (SigLevel = Required); the signing key ships in
mazelinux-keyring. A normal update covers them; nothing special is required.
New default apps reach existing machines through maze-meta: it depends on
every package that makes up a Maze system, so when a package is added to the
default set, your next update installs it automatically.
Do not use pacman -Sy <package> to install a single package against an
un-updated system. On any Arch-based system this produces a partial upgrade and
is a genuine way to break things. Always -Syu.
See also: Kernel Management · Snapshots & Rollback · Known Limitations