'\" t
.\"     Title: ostree admin init-fs
.\"    Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 01/16/2025
.\"    Manual: ostree admin init-fs
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE ADMIN INIT\-F" "1" "" "OSTree" "ostree admin init-fs"
.\" -----------------------------------------------------------------
.\" * 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-admin-init-fs \- Initialize a new root filesystem
.SH "SYNOPSIS"
.HP \w'\fBostree\ admin\ init\-fs\fR\ 'u
\fBostree admin init\-fs\fR [OPTIONS...] {PATH}
.SH "DESCRIPTION"
.PP
Initialize an empty physical root filesystem in the designated PATH, with normal toplevels and correct permissions for each directory\&. Primarily useful for operating system installers\&.
.SH "OPTIONS"
.PP
\fB\-\-modern\fR
.RS 4
Equivalent to
\-\-epoch=1\&.
.RE
.PP
\fB\-\-epoch\fR
.RS 4
This accepts an integer value in the range [0\-1], inclusive\&. The default is zero for compatibility\&.
.sp
When set to 1, the command will skip adding a number of toplevel "API filesystems" such as
/proc
to the toplevel of the physical root\&. These should be unnecessary, as they should only be mounted in the final deployment root\&. The main exception is
/boot, which may need to be mounted in some setups before the target root\&.
.sp
Epoch 2 is the same as 1, except that the toplevel
ostree
directory is mode 0700, denying access from unprivileged code\&. This is a new recommended best practice as it avoids access to old configuration files in
/etc
in previous deployments, as well as potentially old setuid binaries in
/ostree/repo\&.
.RE
.SH "EXAMPLE"
.PP
\fB$ mkdir /example\fR
.PP
\fB$ ostree admin init\-fs \-\-epoch=1 /example\fR
.PP
\fB$ ls /example \fR
.PP
\fIboot\fR\ \&\ \&