FileSystem (fs)

The fs backend stores archives on local disk.

Configuration

# Example aegis.toml configuration:
[backends.my-fs-backend]
type = "fs"
dir = "/path/to/backup/dir"

Options

OptionTypeRequiredDescription
typeStringYesMust be "fs"
dirStringYesThe directory where blobs will be stored— if it does not exist, it will be created

Storage Structure

The backend creates the following directory structure:

{dir}/
├── blobs/
│   ├── ab/
│   │   └── ab123...  # Blob files organized by checksum prefix
│   └── cd/
│       └── cd456...
├── snapshots/
│   └── {repo-name}/
│       ├── 2024-01-01T12:00:00Z  # Snapshot files named by timestamp
│       └── 2024-01-02T12:00:00Z
└── tmp/
    └── ...  # Temporary files during uploads