Your company here — click to reach over 10,000 unique daily visitors

Package ostree

Tool for managing bootable, immutable filesystem trees


libostree is a shared library designed primarily for
use by higher level tools to manage host systems (e.g. rpm-ostree),
as well as container tools like flatpak and the atomic CLI.

Version: 2024.6

See also: ostree-pin.

General Commands

ostree Manage multiple bootable versioned filesystem trees
ostree-admin Use one of the ostree admin commands
ostree-admin-cleanup Delete untagged deployments and repository objects
ostree-admin-config-diff Diff current /etc configuration versus default
ostree-admin-deploy Checkout a revision as the new default deployment
ostree-admin-init-fs Initialize a new root filesystem
ostree-admin-instutil Utility functions intended primarily for operating system installation programs
ostree-admin-lock-finalization Change whether staged deployment will be queued for next boot
ostree-admin-os-init Soft-deprecated alias for stateroot-init
ostree-admin-pin Explicitly retain deployment at a given index
ostree-admin-post-copy Fix up sysroot after a (file based) copy
ostree-admin-set-default Make deployment at a given index the default for the next boot
ostree-admin-set-origin Change the "origin" (location for upgrades)
ostree-admin-stateroot-init Initialize empty state for a given operating system
ostree-admin-status List deployments
ostree-admin-switch Construct new tree from current origin and deploy it, if it changed
ostree-admin-undeploy Delete deployment at a given index
ostree-admin-unlock Prepare the current deployment for hotfix or development
ostree-admin-upgrade Construct new tree from current origin and deploy it, if it changed
ostree-cat Display or concatenate contents of files
ostree-checkout Check out a commit into a filesystem
ostree-checksum Checksum a file or directory
ostree-commit Commit a new revision
ostree-config Change configuration settings
ostree-create-usb Put the given refs on an external drive for P2P distribution.
ostree-diff Compare a directory against a revision
ostree-export Generate a tar archive from an OSTree commit
ostree-find-remotes Find remotes to serve the given refs
ostree-fsck Check the repository for consistency
ostree-gpg-sign Sign a commit
ostree-init Initialize a new empty repository
ostree-log Show log starting at a commit or ref
ostree-ls List file paths
ostree-prepare-root Change the view of a mounted root filesystem to an ostree deployment
ostree-prune Search for unreachable objects
ostree-pull Download data from a remote repository
ostree-pull-local Copy data from a source repository
ostree-refs List refs
ostree-remote Control remote repository configuration
ostree-reset Reset a ref to a previous commit
ostree-rev-parse Output the target of a rev
ostree-show Output a metadata object
ostree-sign Sign a commit
ostree-static-delta Manage static delta files
ostree-summary Regenerate or view the summary metadata file
rofiles-fuse Use FUSE to create a view where directories are writable, files are immutable

File Formats

ostree.repo OSTree repository configuration and layout
ostree.repo-config OSTree repository configuration

System Administration

ostree-state-overlay@.service Set up state overlays