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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bup-0.14.0.tar.gz (67.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bup-0.14.0-py3-none-any.whl (71.3 kB view details)

Uploaded Python 3

File details

Details for the file bup-0.14.0.tar.gz.

File metadata

  • Download URL: bup-0.14.0.tar.gz
  • Upload date:
  • Size: 67.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.3

File hashes

Hashes for bup-0.14.0.tar.gz
Algorithm Hash digest
SHA256 e48b9912332deef10f0c993e78f2a9161823c7397b8787ce96e14fc93148a89c
MD5 f1bc6af5891ebf02d3398e864b72d822
BLAKE2b-256 0e90d1dd154113e744f72f4dcb27729448a23f4a9b9440143eb99e03857fcd7d

See more details on using hashes here.

File details

Details for the file bup-0.14.0-py3-none-any.whl.

File metadata

  • Download URL: bup-0.14.0-py3-none-any.whl
  • Upload date:
  • Size: 71.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.3

File hashes

Hashes for bup-0.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2e6761d46e962a5c11c835073daf0662cfda93b1716eb9b7fd175a055b2e6780
MD5 61f98f10e7cf133eb72658b1f7d59b40
BLAKE2b-256 a5da11c60c18be2257e4468119978ba8c19b5d3a082a10a5b4eb9959fda881dc

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.14.0 This release

2 files

0.13.3

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.0

2 files

0.11.12

2 files

0.11.11

2 files

0.11.10

2 files

0.11.9

2 files

0.4.3

1 file

0.4.2

1 file

0.4.1

1 file

0.4.0

1 file

0.0.1

1 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