ostree.repo(5)

ostree.repo5

Ostree repository configuration and layout

Overview

An OSTree repository is structurally similar to a git repository; it is a content-addressed object store containing filesystem trees. However, unlike git, ostree is designed to store operating system binaries. It records the Unix uid and gid, permissions, as well as extended attributes.

A repository can be in one of three modes; bare, which is designed as a hard link source for operating system checkouts, bare-user, which is like bare but works on systems that run as non-root as well as non-root containers, and archive-z2, which is designed for static HTTP servers.

There is a system repository located at /ostree/repo. If no repository is specified -- either by a command-line option or the OSTREE_REPO environment variable -- the ostree as well as many API calls will use it by default.

Components of a repository

The only user-editable component is the config file. For more information, see ostree.repo-config(5).

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

From ostree 2026.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.