Deploy anything. Break nothing.

# build #5 beside #4, check it, switch
noust update wrenfield.io

# every release on disk, the live one marked
noust releases list wrenfield.io

# point current at the previous release, in seconds
noust releases rollback wrenfield.io

# the app’s journal, credentials masked
noust logs wrenfield.io --follow

# a recipe, health-checked like any app
noust recipe install immich -d photos.kelmoor.dev

One command per action, with the names the console uses. Every command

# Queue an update. The answer is 202, with the job to follow.
curl -X POST https://fra-1.kelmoor.dev/api/jobs/update \
  -H "Authorization: Bearer $NOUST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "wrenfield.io"}'

# Every route the console uses, in one schema.
curl -H "Authorization: Bearer $NOUST_TOKEN" \
  https://fra-1.kelmoor.dev/api/openapi.json

Tokens with a scope and an owner, and an OpenAPI schema at /api/openapi.json. The API

# noust.yaml, at the root of the repository
hooks:
  pre_deploy:
    - run: ./node_modules/.bin/prisma migrate deploy
      timeout: 600
      # rolling back past this release asks you to confirm
      migrates: true
  post_deploy:
    - run: ./scripts/purge-cache.sh

You can also keep it in the repository, in noust.yaml. The schema is closed, so an unknown key is rejected with the name of the field. Deploy hooks

import os
from noust_sdk import Client

client = Client("https://fra-1.kelmoor.dev", token=os.environ["NOUST_TOKEN"])

for app in client.applications.list_apps()["apps"]:
    print(app["domain"], app["status"])

# waits for the health check to finish; raises JobFailed if it fails
queued = client.applications.create_app({
    "domain": "shop.brumaria.es",
    "source": "https://github.com/kelmoor/brumaria-shop.git",
})
job = client.wait_for_job(queued)

A client generated from the same schema. The Python client

provider "noust" {} # NOUST_URL and NOUST_TOKEN

resource "noust_application" "wrenfield" {
  domain   = "wrenfield.io"
  source   = "https://github.com/kelmoor/wrenfield.git"
  branch   = "main"
  app_type = "nodejs"

  env_vars = {
    LOG_LEVEL = "info"
  }
}

Applications, domains and databases as code, for Terraform and OpenTofu. The provider

name: Deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
      # waits for the health check and fails if the deploy does
      - uses: Perkybeet/noust/packaging/github-action@v4.0.0
        with:
          url: https://fra-1.kelmoor.dev
          token: ${{ secrets.NOUST_TOKEN }}
          app: wrenfield.io

It queues the deployment, prints each step and, if the deploy fails, ends with the server’s error message. Deploying from CI