Dokploy Skill

Interact with Dokploy's API to manage projects, applications, domains, and deployments.

Prerequisites

1. Dokploy instance running with API access
2. API Key generated from /settings/profile → "API/CLI Section"
3. Set the DOKPLOY_API_URL environment 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 list

Get project details

dokploy-project get \x3Cproject-id>

Create a new project

dokploy-project create --name "My Project" --description "Description here"

Update a project

dokploy-project update \x3Cproject-id> --name "New Name" --description "Updated"

Delete a project

dokploy-project delete \x3Cproject-id>

List environments in a project

dokploy-project envs \x3Cproject-id>

Applications

List applications in a project

dokploy-app list --project \x3Cproject-id>

Get application details

dokploy-app get \x3Capplication-id>

Create an application

dokploy-app create \
  --environment-id \x3Cenvironment-id> \
  --name "my-app" \
  --type "docker" \
  --image "nginx:latest"

Application types: docker, git, compose

Trigger deployment

dokploy-app deploy \x3Capplication-id>

Get deployment logs

dokploy-app logs \x3Capplication-id> --deployment \x3Cdeployment-id>

List deployments

dokploy-app deployments \x3Capplication-id>

Update application

dokploy-app update \x3Capplication-id> --name "new-name" --env "KEY=VALUE"

Delete an application

dokploy-app delete \x3Capplication-id>

Domains

List domains for an application

dokploy-domain list --app \x3Capplication-id>

Get domain details

dokploy-domain get \x3Cdomain-id>

Add a domain to an application

dokploy-domain create \
  --app \x3Capplication-id> \
  --host "app.example.com" \
  --path "/" \
  --port 80

Update a domain

dokploy-domain update \x3Cdomain-id> --host "new.example.com"

Delete a domain

dokploy-domain delete \x3Cdomain-id>

Environment Variables

List environment variables for an application

dokploy-app env list \x3Capplication-id>

Set environment variable

dokploy-app env set \x3Capplication-id> --key "DATABASE_URL" --value "postgres://..."

Delete environment variable

dokploy-app env delete \x3Capplication-id> --key "DATABASE_URL"

Utility Commands

Check API connection

dokploy-status

View current config

dokploy-config show

API Reference

Base URL: $DOKPLOY_API_URL/api

Notes

• All API calls require the x-api-key header
• Use jq for 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.