coolify-control-cli

Generic CLI for Coolify deployments and diagnostics.

Install

npm install -D coolify-control-cli
# or
pnpm add -D coolify-control-cli

Usage

npx coolifyctl --help
npx coolifyctl resources
npx coolifyctl deploy --tag my-prod-app --force

Global options:

• -p, --profile <name>: profile from local config
• --url <url>: override Coolify URL
• --token <token>: override token directly
• --token-env <name>: use a custom env var for the token
• --json: force JSON output

Project config (recommended)

Create config once per project:

npx coolifyctl init-config

Generated .coolifyrc.json example:

{
  "defaultProfile": "default",
  "profiles": {
    "default": {
      "url": "https://coolify.example.com",
      "tokenEnv": "COOLIFY_TOKEN"
    },
    "staging": {
      "url": "https://coolify-staging.example.com",
      "tokenEnv": "COOLIFY_STAGING_TOKEN"
    }
  }
}

You can also store the same object in package.json under coolify.

Credential resolution order

1. CLI flags (--url, --token, --token-env)
2. Environment (COOLIFY_URL, COOLIFY_TOKEN, or value from --token-env)
3. Profile config from .coolifyrc.json / coolify.config.json / package.json#coolify

Commands

• health
• resources [--query <term>]
• app <uuid>
• logs <uuid> [--lines 200]
• deployments <uuid> [--take 10]
• deployment <uuid>
• deploy [--uuid <resourceUuid> | --tag <resourceTag>] [--pr <number>] [--force]
• init-config

License

MIT