README

A Coqui toolkit that provides full API access to Dokploy, the self-hosted PaaS platform. Manage projects, applications, Docker Compose services, backups, deployments, containers, and domains through natural language.

Installation

composer require coquibot/coqui-toolkit-dokploy

The toolkit is auto-discovered by Coqui — no configuration needed beyond credentials.

Credentials

Two credentials are required:

Set them via the Coqui credentials tool or add to your workspace .env:

DOKPLOY_API_TOKEN=your-api-token-here
DOKPLOY_BASE_URL=https://dokploy.example.com

Tools

Example Workflows

Deploy a new application

1. dokploy_project(action: "list")                              → find your project
2. dokploy_app(action: "create", name: "my-api", environmentId: "...")
3. dokploy_app(action: "build_type", applicationId: "...", buildType: "dockerfile")
4. dokploy_app(action: "env", applicationId: "...", env: "PORT=3000\nNODE_ENV=production")
5. dokploy_domain(action: "create", host: "api.example.com", applicationId: "...", https: true, certificateType: "letsencrypt")
6. dokploy_app(action: "deploy", applicationId: "...")

Deploy from a template

1. dokploy_compose(action: "templates")                          → browse templates
2. dokploy_compose(action: "deploy_template", templateId: "...")  → one-click deploy

Import a docker-compose file

1. dokploy_compose(action: "create", name: "my-stack", environmentId: "...")
2. dokploy_compose(action: "import", composeId: "...", composeFile: "<yaml content>")
3. dokploy_compose(action: "deploy", composeId: "...")

Set up automated backups

1. dokploy_backup(action: "create", databaseType: "postgres", destinationId: "...", schedule: "0 3 * * *")
2. dokploy_backup(action: "run", backupId: "...", databaseType: "postgres")

Troubleshoot a service

1. dokploy_docker(action: "containers_by_app", appName: "my-api")
2. dokploy_app(action: "monitoring", appName: "my-api")
3. dokploy_docker(action: "restart", containerId: "...")

Gated Operations

Destructive operations require user confirmation (unless --auto-approve is enabled):

Development

# Install dependencies
composer install

# Run tests
composer test

# Static analysis
composer analyse

Resource Hierarchy

Project
└── Environment
    ├── Application (single container)
    └── Compose (multi-container stack)
        └── Services

Every application and compose service belongs to a project environment. Use dokploy_project(action: "get", projectId: "...") to discover environment IDs.

Requirements

• PHP 8.4+
• Dokploy instance with API access enabled

License

MIT