API keys & the dbs CLI

Trigger builds from your terminal or any CI system with an API key and the dbs command-line tool.

Create an API key

Open the project → API keys → Create key. Copy it immediately — it's shown once and stored hashed, so it can't be retrieved later. Revoke a key any time from the same page.

Treat API keys like passwords. Put them in your CI provider's secret store, never in source control.

Install the CLI

npm install -g @dalysie-forge/cli
# or run without installing:
npx @dalysie-forge/cli --help

Authenticate

dbs login --key dbs_xxxxxxxx

Or set DBS_API_KEY in the environment (handy in CI).

Trigger a build

dbs build --platform android --variant release --format aab

The CLI uploads your source, starts the build, and can wait for the result and download the artifact.

Use it in CI

Because the key authenticates non-interactively, the same command works in any CI runner. If you'd rather run your whole workflow on BuildStack compute, see Run GitHub Actions CI on BuildStack.

Reference

Run dbs --help (or dbs <command> --help) for the full, always-current command reference.