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 dedicatedflow-hubsystem 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