ostree-admin-unlock1
Prepare the current deployment for hotfix or development
Usage
ostree admin
unlock
[OPTIONS ...]
Overview
Remove the read-only bind mount on /usr and replace it with a writable overlay filesystem. This default invocation of "unlock" is intended for development/testing purposes. All changes in the overlay are lost on reboot. However, this command also supports "hotfixes", see below.
Options
-
--hotfix -
If this option is provided, the current deployment will be cloned as a rollback target. This option is intended for things like emergency security updates to userspace components such as sshd. The semantics here differ from the default "development" unlock mode in that reboots will retain any changes (which is what you likely want for security hotfixes).
-
--transient -
If this option is provided, the overlay filesystem will be mounted read-only. It can still be affected by remounting it as read/write in a new mount namespace. For example:
ostree admin unlock --transient unshare -m -- sh -c 'mount --options-source=disable -o remount,rw /usr && touch /usr/myfile'
Releases
6 releases since Debian 9 (Stretch); the text changed 5 times.
--transient since Arch Linux 2026-11-01.