OSTREE(1)

NAME
ostree - Manage multiple bootable versioned filesystem trees

SYNOPSIS

ostree {COMMAND} [OPTIONS...]

DESCRIPTION

OSTree is a tool for managing multiple bootable versioned filesystem trees, or just "tree" for short. In the OSTree model, operating systems no longer live in the physical "/" root directory. Instead, they parallel install to the new toplevel /ostree directory.

Unlike rpm or dpg, OSTree is only aware of complete filesystem trees. It has no built-in knowledge of what components went into creating the filesystem tree.

It must be emphasized that OSTree only supports read-only trees. To change to a different tree (upgrade, downgrade, install software), a new tree is checked out, and a 3-way merge of configuration is performed. The currently running tree is not ever modified; the new tree will become active on a system reboot.

OPTIONS

The following options are understood:

--repo
    For most commands, when run as non-root, repository is required. If ostree is run as root, it is assumed operations will be performed on the /sysroot/ostree/repo repository.

The following commands are understood:

checkout
    Extract a given branch into the filesystem.

checksum
    Compute the OSTree checksum of the given files.

diff
    Concisely list differences between the given branch revisions, without checking them out into the filesystem.

init
    Initialize a repository.

commit
    Given one or more trees (from the local filesystem, a tarball, or a specified revision for example), create a new commit using those contents.

compose
    A specialized type of commit, intended for merging together many separate filesystem trees such as build artifacts.

local-clone
    Efficiently copy objects and references from one local repository into another.

log
    Show revision log.

ls
    List the contents of a given commit.

fsck
    Check a repository for consistency.

remote
    Manipulate remote archive configuration.

rev-parse
    Show the SHA256 corresponding to a given rev.

run-triggers
    Regenerate cache files in the given operating system tree.

show
    Given an OSTree SHA256 checksum, display its contents.

EXIT STATUS

On success 0 is returned, a non-zero failure code otherwise.

ENVIRONMENT

$PAGER
    ostree respects the traditional pager envrionment variable.

SEE ALSO

ostbuild(1)

AUTHOR

Colin Walters <walters@verbum.org>
    Developer