Quick start
Binary
go install github.com/rjpruitt16/aquifer/cmd/aquifer@latestaquiferThen send it a job and watch it go through the line:
curl -s localhost:8080/jobs -H 'Content-Type: application/json' -d '{ "user_id": "me", "idempotent_key": "first-job", "url": "https://httpbin.org/post", "method": "POST", "body": "{\"hello\":\"aquifer\"}"}'# {"job_id":"c22c473d…","status":"queued"}
curl -N localhost:8080/jobs/<job_id>/stream# event: queued# event: completed (data carries the target API's response_status and body)Docker Compose
docker compose build --pull --no-cachedocker compose up --detachcurl http://127.0.0.1:8080/readyCompose installs the latest checksum-verified release, persists /data, and listens only on loopback by default. See the Docker Compose guide for version pinning and destination allowlisting.
Fly.io
./examples/fly/deploy-quickstart.shThe Fly.io quick start deploys the latest checksum-verified release to a private one-CPU Machine with an encrypted persistent volume. Use fly proxy for local evaluation; Aquifer is not exposed publicly by default.
AWS test node
export AWS_REGION=us-east-2./examples/aws/deploy-quickstart.shThe AWS quick start deploys the latest release to a CIDR-restricted one-vCPU EC2 instance with encrypted local storage. It is intended for evaluation, not production.
Canalis fleet
docker compose -f examples/canalis/compose.yaml up --detach --buildThe Canalis + Aquifer quick start runs two independently persisted Aquifer nodes behind Canalis. The same guide includes tested two-host AWS and private Fly.io deployment paths.
Cross-platform release binaries (linux/darwin, amd64/arm64) are attached to every GitHub Release; no Go toolchain required if you’d rather grab one directly.