aquameta.

Get started

Running in about a minute.

Aquameta is one binary — aqd — and a PostgreSQL database. Install it, point it at a database, open your browser.

01

Before you begin

One prerequisite.

Aquameta needs PostgreSQL 16 or newer — local, or any instance you can reach. The daemon connects to it; everything else — the schema, the code, the interface — lives inside it.

02

Install

Pick your platform.

# Homebrew brew install aquameta/tap/aquameta

PostgreSQL too, if you need it: brew install postgresql@16

# add the apt repository curl -fsSL https://apt.aquameta.org/key.gpg \ | sudo gpg --dearmor -o /usr/share/keyrings/aquameta.gpg echo "deb [signed-by=/usr/share/keyrings/aquameta.gpg] https://apt.aquameta.org stable main" \ | sudo tee /etc/apt/sources.list.d/aquameta.list sudo apt update && sudo apt install aquameta
# x86_64 — swap amd64 → arm64 for ARM curl -fsSL https://get.aquameta.org/latest/aqd-linux-amd64 -o aqd chmod +x aqd sudo mv aqd /usr/local/bin/

Static builds for amd64 and arm64. AMIs available for EC2.

# winget winget install aquameta

Or download the .msi installer.

However you install it, you end up with one command on your path: aqd.

03

First run

Three commands, then a browser.

1

Point it at a database

Generate a config file, then set your database URL and HTTP port.

aqd config > ~/.config/aquameta/myapp.yaml $EDITOR ~/.config/aquameta/myapp.yaml # db url, port, services
2

Initialize

This creates the database and roles, then installs Aquameta’s schemas.

aqd init --config ~/.config/aquameta/myapp.yaml
3

Serve

Start the daemon, then open the address it’s listening on.

aqd serve --config ~/.config/aquameta/myapp.yaml # → http://localhost:8080

That’s it — you’re looking at Aquameta, served by Aquameta.

04

Where to next

Learn the model → Browse the reference →