ezbak
ezbak is a backup manager. It creates, prunes, and restores compressed archives of files and directories on the local filesystem, in AWS S3, or both, with regex file filtering, count-based and time-based retention, and point-in-time restore. It was written primarily to move shared state between jobs and hosts in an orchestrated environment like Nomad or Kubernetes. In that setting the Docker container is the main way to run it; a Python package and a command-line tool run the same backups from your own code or a shell.
ezbak is a small, focused backup manager. It does not aim to replace restic, borg, or a full backup system.
Documentation
Full documentation lives at natelandau.github.io/ezbak:
- Quickstart: a first backup in five minutes
- The orchestration pattern: backups that follow a job across hosts, with Nomad and Kubernetes examples
- Configuration reference: every option across the library, CLI, and environment
Install
uv add ezbak # Python package
uv tool install ezbak # command-line tool
docker pull ghcr.io/natelandau/ezbak:latest # container
ezbak requires Python 3.11 or higher.
Quickstart
Each interface runs the same backup. Every example below writes a
my-backup-<timestamp>.tgz archive to the storage location.
Python:
from ezbak import ezbak
backups = ezbak(name="my-backup", source_paths=["/data"], storage_paths=["/backups"], keep_last=7)
backups.create_backup()
backups.restore_backup(restore_path="/restore")
Command line:
ezbak --name my-backup --storage ~/Backups create --source ~/Documents
Container:
docker run -it \
-v /path/to/source:/source:ro \
-v /path/to/backups:/backups \
-e EZBAK_ACTION=backup \
-e EZBAK_NAME=my-backup \
-e EZBAK_SOURCE_PATHS=/source \
-e EZBAK_STORAGE_PATHS=/backups \
-e EZBAK_KEEP_LAST=7 \
ghcr.io/natelandau/ezbak:latest
See the quickstart for listing and restoring across all three.
Contributing
See CONTRIBUTING.md.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ezbak-1.2.1.tar.gz.
File metadata
- Download URL: ezbak-1.2.1.tar.gz
- Upload date:
- Size: 50.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9099b86e4c3e0e73c7fb167fe903ac74cfe8d40d58c06ee414eb9ba50cda6220
|
|
| MD5 |
4d9ae1579a4192e4f8221923128d1a43
|
|
| BLAKE2b-256 |
5923f15ce0905291a51c17310b0816271db33b9d637f984e5f7a44788cf10294
|
File details
Details for the file ezbak-1.2.1-py3-none-any.whl.
File metadata
- Download URL: ezbak-1.2.1-py3-none-any.whl
- Upload date:
- Size: 60.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23a1b215bf9d5d91c32c2beabbc99abbd36d7c0393aacb6780affac706a93079
|
|
| MD5 |
449fa548695401830e993c777e761b7a
|
|
| BLAKE2b-256 |
5a41d2be8908607213b50f6a3ecfad558fa2421fc97141769273ba82691c2de5
|
