---

name: dokploy-deploy description: Deploy applications to Dokploy using the CLI or API. Use when the user says "deploy to dokploy", "push to production", or "set up dokploy deployment".

Dokploy Deployment

This skill enables you to manage and deploy applications to a Dokploy instance. Dokploy is an open-source PaaS (Platform as a Service) that simplifies deployment on your own VPS.

Prerequisites

• Access to a Dokploy instance.
• Dokploy CLI installed (npm install -g dokploy).
• API Token (generated from Dokploy Dashboard > Settings > Profile).

How to Deploy

1. Using Dokploy CLI

If the CLI is available in the environment:

Copy# Login
dokploy login --host <your-dokploy-host> --token <your-token>

# Create a Project (if not exists)
dokploy project create --name <project-name>

# Create an Application
dokploy app create --name <app-name> --projectName <project-name>

# Deploy
dokploy app deploy --name <app-name> --projectName <project-name>

2. Manual Deployment via Dashboard

1. Navigate to your Dokploy host (e.g., http://vps-ip:3000).
2. Create or select a Project.
3. Add a new Service > Application.
4. Connect your Git Repository (GitHub/GitLab) or use a Docker Image.
5. Configure Nixpacks or Dockerfile for the build.
6. Click Deploy.

Best Practices

• Environment Variables: Always use the Dokploy dashboard or CLI to set secrets. Do not commit .env files.
• Health Checks: Configure health checks in the Dokploy dashboard to ensure zero-downtime deployments.
• Nixpacks: Prefers Nixpacks for automatic language detection and build optimization.

Triggering via API

You can trigger a deployment programmatically using a POST request to the Dokploy API:

CopyPOST https://<your-dokploy-host>/api/deployments/deploy
Authorization: Bearer <your-token>
Content-Type: application/json

{
  "applicationId": "<your-application-id>"
}