Environment Variables

Walsync reads configuration from environment variables and CLI options.

Required Variables

Variable	Description	Example
AWS_ACCESS_KEY_ID	S3 access key	AKIA... or tid_...
AWS_SECRET_ACCESS_KEY	S3 secret key	wJalr... or tsec_...

Optional Variables

Variable	Description	Default
AWS_ENDPOINT_URL_S3	Custom S3 endpoint for Tigris, R2, MinIO, etc.	AWS S3
AWS_REGION	AWS region	auto
RUST_LOG	Log level and filtering	walsync=info

Setting Variables

Shell (temporary)

export AWS_ACCESS_KEY_ID=tid_xxxxx
export AWS_SECRET_ACCESS_KEY=tsec_xxxxx
export AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev

.env file (development)

.env

AWS_ACCESS_KEY_ID=tid_xxxxx
AWS_SECRET_ACCESS_KEY=tsec_xxxxx
AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev

Load with:

source .env
# or use direnv, dotenv, etc.

systemd (production)

[Service]
Environment=AWS_ACCESS_KEY_ID=tid_xxxxx
Environment=AWS_SECRET_ACCESS_KEY=tsec_xxxxx
Environment=AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev

Docker

environment:
  AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID}
  AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY}
  AWS_ENDPOINT_URL_S3: https://fly.storage.tigris.dev

Fly.io

fly secrets set AWS_ACCESS_KEY_ID=tid_xxxxx
fly secrets set AWS_SECRET_ACCESS_KEY=tsec_xxxxx

Variable Precedence

CLI options override environment variables:

# Uses environment variable
export AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev
walsync list --bucket my-bucket

# CLI option overrides environment
walsync list --bucket my-bucket --endpoint http://localhost:9000