.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-init" "1" "2026\-09\-01" "Bup 0.34+"
.SH NAME
bup\-init \- initialize a bup repository
.SH SYNOPSIS
bup init [\-r \f[I]host\f[R]:\f[I]path\f[R]] [\f[I]directory\f[R]]
.SH DESCRIPTION
\f[CR]bup init\f[R] initializes a repository.
The location will be the \f[CR]*directory*\f[R] or \f[CR]\-\-remote\f[R]
if provided, the directory specifed by any global \f[CR]\-d\f[R]
argument (see \f[CR]bup\f[R](1)), the value of \f[CR]BUP_DIR\f[R] in the
environment if set, or \f[CR]\(ti/.bup\f[R].
.PP
See \f[CR]bup\-config(5)\f[R] for configuration options that you may
want to set.
Some, like \f[CR]bup.split.files\f[R] and \f[CR]bup.split.trees\f[R]
should normally be set (when desired) before adding data to the
repository.
.SH OPTIONS
.TP
\-r, \-\-remote=[\f[I]user\f[R]\(at]\f[I]host\f[R]:[\f[I]path\f[R]], \-\-remote=URL
Initialize the specified \f[I]path\f[R] on the given \f[I]host\f[R].
Incompatible with \f[I]directory\f[R].
See bup(1) REMOTE OPTIONS for further information.
.SH EXAMPLES
.IP
.EX
bup init \(ti/archive
.EE
.SH SEE ALSO
\f[CR]bup\-config(5)\f[R], \f[CR]ssh_config\f[R](5)
.SH BUP
Part of the \f[CR]bup\f[R](1) suite.
.SH AUTHORS
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.