Skip to main content

Start it

That last command prints an API key. It’s shown once — store it now. The compose file publishes the node on 127.0.0.1:8080 only, not on your network. On first start the node generates its receipt-signing key and writes it into the keys volume.
Change POSTGRES_PASSWORD in docker-compose.yml before running this anywhere but your own machine. Back up the keys volume — receipts are verified against that key forever.

Services

docker-compose.yml defines two services:
  • db — PostgreSQL 16, with its data in the db volume.
  • node — built from the repo’s node/Dockerfile, depends on db being healthy, and keeps its signing key in the keys volume.

Environment variables

The node container reads these from the compose file’s environment: block (each falls back to the shown default if unset in your shell): POAW_DATABASE_URL is set for you in the compose file, pointing at the db service.

Next

Create more workspaces at any time with the same create-workspace command, and see the CLI page for every other poaw-node subcommand and environment variable, including anchoring.