Coolify

Coolify Deployment Skill (v2.2.0)

Manage deployments on Coolify self-hosted platform using the Python CLI script.

Setup

1. Set API Token

export COOLIFY_API_TOKEN="your-api-token"

Get your token from https://coolify.bradarr.com → Settings → API Keys.

2. Test Installation

python scripts/coolify.py status

Commands

Quick Status

python scripts/coolify.py status

Shows all applications, projects, and servers with counts.

Applications

List All Applications

python scripts/coolify.py apps list

Shows all applications with status icons.

Get Application Details

python scripts/coolify.py apps get --uuid <uuid>

Shows full details for one application.

Deploy Application

python scripts/coolify.py apps deploy --uuid <uuid>
python scripts/coolify.py apps deploy --uuid <uuid> --no-force  # Don't force rebuild

Wait for Deployment

python scripts/coolify.py apps wait --uuid <uuid>
python scripts/coolify.py apps wait --uuid <uuid> --timeout 600  # 10 minute timeout

Blocks until deployment completes or times out.

Get Logs

python scripts/coolify.py apps logs --uuid <uuid>
python scripts/coolify.py apps logs --uuid <uuid> --count 200  # More lines

Create Application

python scripts/coolify.py apps create \
  --name my-app \
  --repository https://github.com/user/repo \
  --build-pack dockerfile \
  --branch main

Projects

python scripts/coolify.py projects list

Servers

python scripts/coolify.py servers list

Programmatic Usage

Import the API directly in Python scripts:

from scripts.coolify import CoolifyAPI

api = CoolifyAPI()

# Check health
if not api.health_check():
    print("API not accessible!")

# List apps
apps = api.apps_list()
for app in apps:
    print(f"{app['name']}: {app['status']}")

# Create and deploy
app = api.apps_create(
    name="my-app",
    repository="https://github.com/user/repo"
)
print(f"Created: {app['uuid']}")

# Wait for deployment
result = api.apps_wait_for_deployment(app['uuid'], timeout=300)
print(result['message'])

Common Workflows

Deploy New Application with Custom Domain

# Create the application
python scripts/coolify.py apps create \
  --name my-website \
  --repository https://github.com/user/my-website

# Get the UUID from output, then add domain
# Note: Custom domain requires manual traefik configuration

# Deploy
python scripts/coolify.py apps deploy --uuid <uuid>

# Wait for completion
python scripts/coolify.py apps wait --uuid <uuid>

Check Application Health

# Get status
python scripts/coolify.py apps get --uuid <uuid> | grep status

# Get logs if unhealthy
python scripts/coolify.py apps logs --uuid <uuid>

Error Handling

"COOLIFY_API_TOKEN not set"

export COOLIFY_API_TOKEN="your-token"

"Invalid UUID format"

Ensure UUID is in correct format (e.g., w8ogsc44w0cswcww8wwwg8o4)

"Repository URL must start with https://, http://, git://, or git@"

# Wrong
--repository github.com/user/repo

# Correct
--repository https://github.com/user/repo

Deployment fails

# Check logs
python scripts/coolify.py apps logs --uuid <uuid>

API Reference

CoolifyAPI Methods

Validators

from scripts.coolify import CoolifyValidators

# Validate inputs before API calls
CoolifyValidators.validate_uuid(uuid)
CoolifyValidators.validate_repository_url(url)
CoolifyValidators.validate_domain(domain)
CoolifyValidators.validate_build_pack(pack)

Environment Variables

Known UUIDs (Clawd Workspace)

See Also

• Coolify Dashboard: https://coolify.bradarr.com
• Coolify Docs: https://coolify.io/docs

🦞 Deploy with confidence