- name
- dokploy
- description
- Manage Dokploy deployments, projects, applications, and domains via the Dokploy API.
- emoji
- 🐳
- metadata
- clawdhub
- requires
- bins
- ["curl", "jq"]
Dokploy Skill
Interact with Dokploy's API to manage projects, applications, domains, and deployments.
Prerequisites
- Dokploy instance running with API access
- API Key generated from
/settings/profile→ "API/CLI Section" - Set the
DOKPLOY_API_URLenvironment variable (default:http://localhost:3000)
Configuration
Set these environment variables or use the config command:
# Dokploy instance URL
export DOKPLOY_API_URL="https://your-dokploy-instance.com"
# Your API token
export DOKPLOY_API_KEY="your-generated-api-key"
# Or run the config command
dokploy-config set --url "https://your-dokploy-instance.com" --key "your-api-key"Projects
List all projects
dokploy-project listGet project details
dokploy-project get <project-id>Create a new project
dokploy-project create --name "My Project" --description "Description here"Update a project
dokploy-project update <project-id> --name "New Name" --description "Updated"Delete a project
dokploy-project delete <project-id>List environments in a project
dokploy-project envs <project-id>Applications
List applications in a project
dokploy-app list --project <project-id>Get application details
dokploy-app get <application-id>Create an application
dokploy-app create \
--environment-id <environment-id> \
--name "my-app" \
--type "docker" \
--image "nginx:latest"Application types: docker, git, compose
Trigger deployment
dokploy-app deploy <application-id>Get deployment logs
dokploy-app logs <application-id> --deployment <deployment-id>List deployments
dokploy-app deployments <application-id>Update application
dokploy-app update <application-id> --name "new-name" --env "KEY=VALUE"Delete an application
dokploy-app delete <application-id>Domains
List domains for an application
dokploy-domain list --app <application-id>Get domain details
dokploy-domain get <domain-id>Add a domain to an application
dokploy-domain create \
--app <application-id> \
--host "app.example.com" \
--path "/" \
--port 80Update a domain
dokploy-domain update <domain-id> --host "new.example.com"Delete a domain
dokploy-domain delete <domain-id>Environment Variables
List environment variables for an application
dokploy-app env list <application-id>Set environment variable
dokploy-app env set <application-id> --key "DATABASE_URL" --value "postgres://..."Delete environment variable
dokploy-app env delete <application-id> --key "DATABASE_URL"Utility Commands
Check API connection
dokploy-statusView current config
dokploy-config showAPI Reference
Base URL: $DOKPLOY_API_URL/api
| Endpoint | Method | Description |
|---|---|---|
/project.all | GET | List all projects |
/project.create | POST | Create project |
/project.one | GET | Get project by ID |
/project.update | POST | Update project |
/project.remove | POST | Delete project |
/application.search | GET | List applications |
/application.create | POST | Create application |
/application.one | GET | Get application by ID |
/application.update | POST | Update application |
/application.delete | POST | Delete application |
/application.deploy | POST | Trigger deployment |
/deployment.all | GET | List deployments |
/deployment.byId | GET | Get deployment by ID |
/deployment.logs | GET | Get deployment logs |
/domain.all | GET | List domains |
/domain.create | POST | Create domain |
/domain.update | PATCH | Update domain |
/domain.delete | DELETE | Delete domain |
Notes
- All API calls require the
x-api-keyheader - Use
jqfor JSON parsing in scripts - Some operations require admin permissions
- Deployment is asynchronous — use status endpoint to check progress
- Note: Currently, Dokploy only provides a REST API for Deployment Logs. Real-time Application Runtime Logs (container logs) are only available via WebSocket and cannot be accessed through this CLI skill.