S3 archival

Mon, 01 Jan 0001 00:00:00 +0000

If you want bottomless cloud storage, enable S3 mode. mxRaven writes incoming .eml files directly to your bucket via S3_STORE, and perch reconciles the bucket automatically.

export MXRAVEN_API_TOKEN=...
export PERCH_S3_SECRET_KEY=...

perch setup \
 --config ~/.local/share/perch/perch.yaml \
 --data-dir ~/.local/share/perch \
 --workspace my-workspace \
 --domain example.com \
 --hostname mail.example.com \
 --storage s3 \
 --s3-bucket my-mail-archive \
 --s3-region auto \
 --s3-endpoint https://<account>.r2.cloudflarestorage.com \
 --s3-access-key <access-key>

To expose perch directly on a public VPS with standard ports and automatic Let’s Encrypt certificates, add:

Storage on perch docs

S3 archival