Skip to main content

bup

backup for github repos and AWS S3 and DynamoDB

Exclusions

Each backup type (S3, DynamoDB, GitHub) has an exclusion list: names to skip, one per line. S3 entries are bucket names, DynamoDB entries are table names, and GitHub entries are either a repo name (my-repo) or owner/my-repo. Exclusion lists are edited in the GUI's "Exclusions" box for each backup type.

The same syntax applies to all three lists (S3 buckets, DynamoDB tables, and GitHub repos):

  • # starts a comment that runs to the end of the line. This works for whole-line comments and for inline trailing comments, e.g. my-bucket # too big, backed up elsewhere.
  • Blank and whitespace-only lines are ignored.
  • Leading and trailing whitespace around a name is ignored, so my-bucket matches my-bucket.
  • Names are matched exactly (no wildcards).
# S3 buckets to skip
logs-archive        # 2 TB, backed up by a lifecycle rule instead
scratch-bucket

Security Notes

  • Credentials you enter (AWS secret access key, GitHub token) are stored unencrypted in a local SQLite preferences database in your user profile. Prefer AWS profiles (~/.aws/credentials) over raw keys where possible, and treat the preferences database with the same care as a credentials file.
  • GitHub authentication for clone/pull is passed to git via the process environment, so the token is not written into each backup's .git/config. Backups made by older versions of bup may still have a token embedded in their remote URL; bup scrubs these the next time each repo is pulled.

Acknowledgements

Icons made by Freepik from www.flaticon.com

Release files for bup 0.14.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bup 0.14.0
File Size Uploaded
bup-0.14.0.tar.gz 67.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bup 0.14.0
File Interpreter ABI Platform
bup-0.14.0-py3-none-any.whl Python 3 none any Details

Total release size: 138.6 kB

Release files / bup-0.14.0.tar.gz

Download URL bup-0.14.0.tar.gz
Size 67.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e48b9912332deef10f0c993e78f2a9161823c7397b8787ce96e14fc93148a89c
BLAKE2b-256 checksum
How to use checksums
0e90d1dd154113e744f72f4dcb27729448a23f4a9b9440143eb99e03857fcd7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / bup-0.14.0-py3-none-any.whl

Download URL bup-0.14.0-py3-none-any.whl
Size 71.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2e6761d46e962a5c11c835073daf0662cfda93b1716eb9b7fd175a055b2e6780
BLAKE2b-256 checksum
How to use checksums
a5da11c60c18be2257e4468119978ba8c19b5d3a082a10a5b4eb9959fda881dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release history Release notifications | RSS feed

This release

0.14.0 This release

2 release files

0.13.3

2 release files

0.13.2

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.0

2 release files

0.11.9

2 release files

0.4.3

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page