Flow

Deployment

Local development, systemd services, and the make deploy flow.

Prerequisites

  • Go 1.26+
  • Bun 1.3+
  • Docker

AiStor requires a license file at ./minio.license. Get one at min.io/pricing.

Local setup

make setup
make build

docker compose up -d

Running locally

# In separate terminals:
make run-server
make run-worker

Code generation

The API server and TypeScript client are generated from the OpenAPI spec at api/openapi.yaml.

# all (API + JS client)
make generate

Production deploy

Two flavors:

  • make deploy — installs the server as a systemd-user service under a dedicated flow-hub system user. Recommended.
  • make deploy-root — installs as a system-level systemd unit at /etc/systemd/system/flow-hub.service.

Both build a stripped Linux/amd64 binary, scp the artifacts to $DEPLOY_HOST, and run the matching deploy script over SSH.

DEPLOY_HOST=flow-hub-prod make deploy

Tearing down

User mode:

make stop-systemd

Root mode:

make stop-systemd-root