Scroll to navigation

bup(1) bup(1)


bup - Backup program using rolling checksums and git file formats


bup [global options...] <command> [options...]


bup is a program for making backups of your files using the git file format.

Unlike git(1) itself, bup is optimized for handling huge data sets including individual very large files (such a virtual machine images). However, once a backup set is created, it can still be accessed using git tools.

The individual bup subcommands appear in their own man pages.


print bup’s version number. Equivalent to bup-version(1)
use the given BUP_DIR parameter as the bup repository location, instead of reading it from the $BUP_DIR environment variable or using the default ~/.bup location.


Check backup sets for damage and add redundancy information
Browse backup sets using an ftp-like client
Mount your backup sets as a filesystem
Print detailed help for the given command
Create or display the index of files to back up
Backup a remote machine to the local one
Extract files from a backup set
Save files into a backup set (note: run “bup index” first)
Launch a web server to examine backup sets


Deliberately destroy data
Recursively list files in your filesystem
Initialize a bup repository
Retrieve a file backed up using bup-split(1)
Browse the files in your backup sets
Determine how close your bup repository is to armageddon
Test bup memory usage statistics
Index objects to speed up future backups
Make sure progress messages don’t overlap with output
Generate a stream of random output
The server side of the bup client-server relationship
Split a single file into its own backup set
Wait for up to one second.
Report the version number of your copy of bup.


If set to true, yes, or 1, assume the version of git in the path is acceptable.


git(1) and the README file from the bup distribution.

The home of bup is at <>.


Avery Pennarun <>.

2021-02-06 Bup 0.32