Files
stack/packages/mosaic/framework/tools/coolify
Jason Woltje 6ad96c37cd
All checks were successful
ci/woodpecker/pr/ci Pipeline was successful
ci/woodpecker/push/ci Pipeline was successful
feat(framework): P1+P2 — public sanitization + blocking CI gate
Adds tools/quality/scripts/verify-sanitized.sh (two-class, self-tested) wired
blocking in .woodpecker/ci.yml; sanitizes operator identity from the public
framework package so the gate is green.

- purge jarvis/jason/woltje/PDA across 26 files -> generic
- delete jarvis-loop.json overlay; add neutral examples/{personas,overlays}
- relocate maintainer AUDIT to docs/audits/; delete 2 jarvis-brain rule blocks
- neutralize SOUL persona; strip "(Policy: Jason ...)" keeping universal rule
- test fixtures jason.woltje -> ci-bot (both git tests pass)

Deferred (tracked): private third-party host (uscllc) genericization.

Refs #542, closes #571

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 20:57:08 -05:00
..

Coolify Tool Suite

Manage Coolify container deployment platform (projects, services, deployments, environment variables).

Prerequisites

  • jq and curl installed
  • Coolify credentials in ~/.config/mosaic/credentials.json (or $MOSAIC_CREDENTIALS_FILE)
  • Required fields: coolify.url, coolify.app_token

Scripts

Script Purpose
team-list.sh List teams
project-list.sh List projects
service-list.sh List all services
service-status.sh Get service details and status
deploy.sh Trigger service deployment
env-set.sh Set environment variable on a service

Common Options

  • -f json — JSON output (default: table)
  • -u uuid — Service UUID (for service-specific operations)
  • -h — Show help

API Reference

  • Base URL: http://10.1.1.44:8000
  • API prefix: /api/v1/
  • Auth: Bearer token in Authorization header
  • Rate limit: 200 requests per interval

Known Limitations

  • FQDN updates on compose sub-apps not supported via API. Workaround: update directly in Coolify's PostgreSQL DB (coolify-db container, service_applications table).
  • Compose must be base64-encoded in docker_compose_raw field when creating services via API.
  • Don't send type with docker_compose_raw — API rejects payloads with both fields.

Coolify Magic Variables

Coolify reads special env vars from compose files:

  • SERVICE_FQDN_{NAME}_{PORT} — assigns a domain to a compose service
  • SERVICE_URL_{NAME}_{PORT} — internal URL reference
  • Must use list-style env syntax (- SERVICE_FQDN_API_3001), NOT dict-style.

Examples

# List all projects
~/.config/mosaic/tools/coolify/project-list.sh

# List services as JSON
~/.config/mosaic/tools/coolify/service-list.sh -f json

# Check service status
~/.config/mosaic/tools/coolify/service-status.sh -u <uuid>

# Set an env var
~/.config/mosaic/tools/coolify/env-set.sh -u <uuid> -k DATABASE_URL -v "postgres://..."

# Deploy a service
~/.config/mosaic/tools/coolify/deploy.sh -u <uuid>