bup-init(1) Bup 0.34+

Avery Pennarun

2026-09-01

NAME

bup-init - initialize a bup repository

SYNOPSIS

bup init [-r host:path] [directory]

DESCRIPTION

bup init initializes a repository. The location will be the *directory* or --remote if provided, the directory specifed by any global -d argument (see bup(1)), the value of BUP_DIR in the environment if set, or ~/.bup.

See bup-config(5) for configuration options that you may want to set. Some, like bup.split.files and bup.split.trees should normally be set (when desired) before adding data to the repository.

OPTIONS

-r, --remote=[user@]host:[path], --remote=URL
Initialize the specified path on the given host. Incompatible with directory. See bup(1) REMOTE OPTIONS for further information.

EXAMPLES

bup init ~/archive

SEE ALSO

bup-config(5), ssh_config(5)

BUP

Part of the bup(1) suite.