How to Install Dokploy: A Complete Step-by-Step Guide for Beginners

Full Guide:

1. Introduction — What is Dokploy?

Dokploy is a self-hosted PaaS (Platform-as-a-Service) that makes it easy to deploy, manage, and scale web applications on your own infrastructure. It offers a Heroku-like experience while giving you full control over your data, resources, and costs.

2. Prerequisites

Before installing Dokploy, make sure you have:

1. Server Requirements: Minimum 2 GB RAM, 30 GB disk space.
2. Supported OS: Ubuntu (24.04, 23.10, 22.04, 20.04, 18.04), Debian (12, 11, 10), Fedora 40, CentOS 8 & 9.
3. SSH Access: Root or sudo privileges.
4. Open Ports: 3000 (UI), 80/443 (if using HTTPS).
5. Internet Access: Required for installation and updates.

💡 Tip: If you face issues with Ubuntu 24.04, try Ubuntu 22.04.

3. Preparing Your Server

1. Create a VPS (Hetzner, DigitalOcean, Vultr, AWS, etc.).
2. SSH into the server: ssh root@server-ip
3. (Optional) Configure firewall: 

sudo ufw allow OpenSSHsudo ufw allow 3000sudo ufw allow 80sudo ufw allow 443sudo ufw enable

4. Installing Dokploy (One-Line Method)

   Run the official installation script:

curl -sSL https://dokploy.com/install.sh | sh

   This installs Docker (if missing), Dokploy, and all dependencies.

5. Accessing the Dokploy Dashboard

1. Open in browser: http://server-ip:3000
2. Create an Admin account.
3. Create projects, connect Git repositories, deploy apps, and set up domains & SSL.

6. Optional: Manual Installation (Advanced)

For more control, install via Docker Swarm with docker swarm init and create services manually for PostgreSQL, Redis, Traefik, and Dokploy.

7. First Deployment

• Create a project
• Connect GitHub/GitLab repository
• Configure build settings
• Add domain & enable SSL

8. Tips & Troubleshooting

• Try Ubuntu 22.04 if you face script errors.
• Keep ports open.
• Update regularly:

dokploy update