Docs/The Runko CLI

The Runko CLI

Drive everything from your terminal — deploys, logs, env, jobs and rollbacks.

The runko CLI is a first-class client for the platform. Anything you can do in the dashboard, you can script from the terminal or CI.

Install

bash

npm i -g runko-cli

Common commands

bash

runko deploy            # build & deploy current dir
runko logs -f           # live tail service logs
runko ps                # list services and status
runko env set KEY=value # set an environment variable
runko run 'rails db:migrate'  # one-off job
runko rollback          # revert to the previous deploy
runko open              # open the service in your browser

Using in CI

Create a service token in the dashboard and export it as RUNKO_TOKEN. The CLI picks it up automatically — no interactive login needed.

yaml

# .github/workflows/deploy.yml
- run: npm i -g runko-cli
- run: runko deploy --service api
  env:
    RUNKO_TOKEN: ${{ secrets.RUNKO_TOKEN }}

← Previous

Quickstart

Web Services