Compose Quickstart

The supported release path starts PostgreSQL, MinIO, the control plane, gateway, node services, and a smoke workload from published artifacts.

Start Axern

git clone https://github.com/cofy-x/axern.git
cd axern
make quickstart

make quickstart waits for readiness and runs a core smoke through the public gateway. The generated CLI and context stay under deploy/local/state/.

Run a sandbox

AXERN_CLI=deploy/local/state/releases/v$(cat VERSION)/axern

"${AXERN_CLI}" context current
"${AXERN_CLI}" catalog list
"${AXERN_CLI}" run create \
  --template-id python311 \
  --runtime-class runsc \
  --argv python \
  --argv -c \
  --argv 'print("hello from Axern")' \
  --wait

Use --output json for automation. A normally terminated run create --wait returns the workload’s exit code.

Inspect and clean up

make local-compose-status
make local-compose-purge

Purge removes the Compose containers, generated state, and local development database. It does not delete unrelated Docker resources.

Develop from source

The source path remains separate and builds the current checkout into local :dev images:

make quickstart-source

Both paths exercise the same Compose and public gateway contract.