borg-create(1) borg (NAME) borg-create - (SYNOPSIS) borg [ ] create [] ARCHIVE [PATH...] (DESCRIPTION) . . ( ) /./ : /this/gets/stripped/./this/gets/archived ./ ( this/gets/archived ). '-' Borg 'stdin' . --content-from-command . " stdin" . . . '.checkpoint' '.checkpoint.N' ( N ) . : {now} {utcnow} {fqdn} {hostname} {user} . . . --files-cache : o ctime,size,inode () o mtime,size,inode ( 1.1.0rc4) o ctime,size ( inode) o mtime,size ( inode) o rechunk,ctime ( - ctime ) o rechunk,mtime ( - mtime ) o disabled ( - ) inode: inode . SSHFS inode . inode . ctime mtime: o ctime ( ) . ctime / . ctime . chown chmod ctime . o mtime . mtime mtime . mtime . --files-changed Borg : o ctime (): ctime . . o mtime: mtime . o disabled: . . (snapshots) . bind mount . --progress ( O C D) (N) . --stats - "This Archive" . --quick-stats . --stats --quick-stats --dry-run . borg_patterns . borg_placeholders . (OPTIONS) Borg borg-common(1) . (arguments) ARCHIVE ( ) PATH (options) -n, --dry-run ( ) -s, --stats --quick-stats --list ( ...) --filter STATUSCHARS ( ) --json JSON ( --stats) --no-cache-sync : . . --stdin-name NAME NAME (: 'stdin') --stdin-user USER USER (: 'root') --stdin-group GROUP GROUP (: 'wheel') --stdin-mode M M stdin (: 0660) --content-from-command PATH --paths-from-stdin stdin --paths-from-command PATH --paths-from-stdin --paths-delimiter DELIM --paths-from-stdin --paths-from-command (: ) / (Include/Exclude options) -e PATTERN, --exclude PATTERN PATTERN --exclude-from EXCLUDEFILE EXCLUDEFILE ( ) --pattern PATTERN PATTERN --patterns-from PATTERNFILE / PATTERNFILE --exclude-caches CACHEDIR.TAG --exclude-if-present NAME NAME --keep-exclude-tags --exclude-if-present --exclude-nodump NODUMP --exclude-dataless DATALESS ( macOS) (Filesystem options) -x, --one-file-system --numeric-owner --numeric-ids --numeric-ids --noatime (atime) --atime (atime) --noctime ctime --nobirthtime (birthtime) --nobsdflags --noflags --noflags ( NODUMP IMMUTABLE) --noacls (ACL) --noxattrs (xattrs) --sparse (sparse holes) --files-cache MODE (: ctime,size,inode) --files-changed MODE (: ctime) --read-special FIFO (Archive options) --comment COMMENT --timestamp TIMESTAMP ( UTC ) -c SECONDS, --checkpoint-interval SECONDS (: ) --chunker-params PARAMS ( ) -C COMPRESSION, --compression COMPRESSION (EXAMPLES) # ~/Documents "my-documents" $ borg create /path/to/repo::my-documents ~/Documents # $ borg create --list /path/to/repo::my-documents ~/Documents # $ borg create /path/to/repo::docs /mnt/disk/./docs # pyc $ borg create /path/to/repo::my-files \ ~/Documents \ ~/src \ --exclude '*.pyc' # zlib $ borg create -C zlib,6 --one-file-system /path/to/repo::root-{now:%Y-%m-%d} / # SSH $ borg create ssh://borg@backup.example.org:2222/path/to/repo::{fqdn}-root-{now} / # $ borg create --compression none /path/to/repo::arch ~ # (lz4) $ borg create /path/to/repo::arch ~ # lzma $ borg create --compression lzma,9 /path/to/repo::arch ~ # find $ find ~ -size -1000k | borg create --paths-from-stdin /path/to/repo::small-files-only (NOTES) --exclude tar --exclude '*/.bundler/gems' . -x --one-file-system . stat . (Error handling) Borg ( ) . (Item flags) --list : o o o o o : stdin '-' --content-from-command . (SEE ALSO) borg-common(1), borg-delete(1), borg-prune(1), borg-check(1), borg-patterns(1), borg-placeholders(1), borg-compression(1) (Author) The Borg Collective 2026-07-18 borg-create(1)