Dokploy Deployment
0Dokploy is an open-source PaaS that allows users to deploy and manage applications on a self-hosted instance using Docker and Traefik. It is intended for developers looking for an alternative platform to Vercel or Heroku.
200Updated Today
Deployment
Quick InstallView Source
$ npx skills add https://github.com/sattva2020/skills --skill dokploy-api-mcpOverview
About This Skill
This skill provides full API integration for managing self-hosted Dokploy instances, covering projects, applications, databases, and domains. It includes an interactive setup process to configure your Dokploy URL and API credentials, along with comprehensive guides for Next.js deployments and common pitfalls. The skill is designed for developers who want to manage containerized deployments on their own infrastructure without relying on external PaaS platforms. Setup involves running a Python configuration script that guides you through connecting your Dokploy instance via API key authentication.
How to Use
Install via CLI using the command provided and follow the setup instructions in the documentation.
Use Cases
Deploy applications using Dokploy
Manage application configurations on Dokploy
Access and utilize the Dokploy API for automation
View application health and logs on the dashboard
Tags
Setup & Installation
Quick Install
Terminal
$ npx skills add https://github.com/sattva2020/skills --skill dokploy-api-mcpAlternative Install (Git Clone)
git clone https://github.com/sattva2020/skillsRequirements
- Claude Code or compatible AI agent
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Deploy my [APPLICATION_NAME] app to my Dokploy instance. The app is a [APP_TYPE] built with [TECH_STACK]. Here’s the GitHub repo: [REPO_URL]. I want it to be accessible at [SUBDOMAIN].[DOMAIN].com. Use the Dokploy CLI or dashboard to set up the deployment with the following requirements: [REQUIREMENTS]. If environment variables are needed, use these: [ENV_VARS].
Example Output
# Dokploy Deployment Report for 'Acme CRM'
## Deployment Summary
- **Status**: ✅ Successfully deployed
- **App Name**: Acme CRM
- **Subdomain**: crm.acmecorp.com
- **Tech Stack**: Next.js + PostgreSQL
- **GitHub Repo**: https://github.com/acmecorp/acme-crm
## Configuration Applied
```yaml
version: '3.8'
services:
web:
image: ghcr.io/acmecorp/acme-crm:latest
labels:
- "traefik.enable=true"
- "traefik.http.routers.acme-crm.rule=Host(`crm.acmecorp.com`)"
- "traefik.http.routers.acme-crm.entrypoints=websecure"
- "traefik.http.routers.acme-crm.tls.certresolver=letsencrypt"
environment:
- DATABASE_URL=postgresql://user:pass@db:5432/acme
- NEXT_PUBLIC_API_URL=https://api.acmecorp.com
networks:
- dokploy-network
db:
image: postgres:15
environment:
- POSTGRES_USER=user
- POSTGRES_PASSWORD=pass
- POSTGRES_DB=acme
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- dokploy-network
volumes:
postgres_data:
networks:
dokploy-network:
external: true
```
## Steps Taken
1. **GitHub Integration**: Connected repo `acme-crm` to Dokploy via GitHub OAuth.
2. **Subdomain Setup**: Configured Traefik to route `crm.acmecorp.com` to the app.
3. **Environment Variables**: Applied secrets from Dokploy’s vault for `DATABASE_URL` and `NEXT_PUBLIC_API_URL`.
4. **Database**: Deployed a PostgreSQL container with persistent storage.
5. **SSL**: Enabled Let’s Encrypt for HTTPS (cert issued for `crm.acmecorp.com`).
## Access Details
- **Live URL**: https://crm.acmecorp.com
- **Logs**: Available in Dokploy dashboard under 'Acme CRM' → Logs.
- **Monitoring**: CPU/Memory usage tracked in real-time.
## Next Steps
- Run `dokploy backup` to export the deployment config.
- Configure a custom domain (e.g., `crm.company.com`) via Dokploy’s DNS settings.
Need help? Join the [Dokploy Discord](https://discord.gg/dokploy) or check the [docs](https://dokploy.com/docs).Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan