Deploy from GitHub Actions

Before you start

Link the repository to your server in the panel, on the server's GitHub tab, and turn off deploy on push there, so only your workflow deploys. Deploys are run by the server's owner, so the key must belong to the owner and must not be limited to a set of permissions; limit it to this one server instead.

In the repository on GitHub, open Settings, Secrets and variables, Actions, and add the key as a secret named SILLYDEV_API_KEY.

The workflow

This runs your tests on every push to main, and asks for a deploy only if they pass. The deploy request answers at once with the queued deployment; the deploy itself pulls the branch, installs dependencies and restarts the bot, as a deploy from the panel does.

name: Test and deploy

on:
  push:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm ci
      - run: npm test

  deploy:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to Silly Development
        run: |
          curl --fail-with-body -X POST \
            "https://sillydev.co.uk/panel/api/client/servers/1a7ce997/git/deploy" \
            -H "Authorization: Bearer ${{ secrets.SILLYDEV_API_KEY }}" \
            -H "Accept: application/json"

How often you can deploy

A server starts at most one deploy every 15 minutes on the free plan and every minute on a paid one. A request inside that window is not refused: it waits, and its run_after says when it will start. Only the newest waiting deploy is kept, so a burst of pushes ends in one deploy of the latest commit.

To see how a deploy went, GET /servers/{server}/git lists recent deployments with their status and any error.