'\" t
.\"     Title: ostree.repo
.\"    Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 12/12/2016
.\"    Manual: ostree.repo
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE\&.REPO" "5" "" "OSTree" "ostree.repo"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ostree.repo \- OSTree repository configuration and layout
.SH "DESCRIPTION"
.PP
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\&.
.PP
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\&.
.PP
There is a system repository located at
/ostree/repo\&. If no repository is specified \-\- either by a command\-line option or the
\fBOSTREE_REPO\fR
environment variable \-\- the
\fBostree\fR
as well as many API calls will use it by default\&.
.SH "COMPONENTS OF A REPOSITORY"
.PP
The only user\-editable component is the
config
file\&. For more information, see
\fBostree.repo-config\fR(5)\&.
.SH "SEE ALSO"
.PP
\fBostree\fR(1),
\fBostree.repo-config\fR(1)