How to Install Dokploy on Ubuntu Server

Table of Contents

If you are looking for a simple and open-source deployment platform, Dokploy is a great option. It helps developers to deploy and manage applications easily using Docker and Traefik. Dokploy is considered as an alternative to platforms like Heroku, Vercel, and Netlify. It is lightweight, beginner-friendly, and designed for self-hosting.

In this guide, you’ll learn how to install Dokploy on Ubuntu Server, configure the dashboard, and secure your deployment environment for production use.

Quick Answer

Dokploy can be installed on an Ubuntu server using a single installation script. The installer automatically sets up Docker, Docker Swarm, and Traefik, allowing you to manage and deploy applications through an easy-to-use web dashb

Installation command:

curl -sSL https://dokploy.com/install.sh | sh
Once installed, access the dashboard via:
http://YOUR_SERVER_IP:3000

What Is Dokploy?

Dokploy is an open-source application deployment platform designed for developers and DevOps teams who want complete control over their infrastructure.

It simplifies application deployment by providing a web-based interface that integrates with:

  • Docker
  • Docker Swarm
  • Traefik
  • Git repositories
  • SSL certificate automation

Many developers consider Dokploy a self-hosted alternative to:

  • Heroku
  • Vercel
  • Netlify

Unlike managed platforms, Dokploy allows you to host applications on your own VPS while maintaining full infrastructure control.

Why Use Dokploy?

Dokploy offers several advantages for developers and businesses:

Benefits of Dokploy

  • Simple installation process
  • Open-source and self-hosted
  • Docker-native deployment
  • Built-in reverse proxy management
  • Automated SSL certificate support
  • Multi-application management
  • Resource-efficient architecture
  • Beginner-friendly dashboard

For teams looking to reduce hosting costs while maintaining deployment flexibility, Dokploy can be an excellent choice.

Prerequisites

Before installing Dokploy, make sure you have the following:

  • A Linux VPS server (Ubuntu, Debian, Fedora, or CentOS)
  • Minimum 2GB RAM and 30GB storage recommended
  • Root or sudo access
  • Open ports:
    • 80 (HTTP)
    • 443 (HTTPS)
    • 3000 (Dokploy dashboard)
  • Basic knowledge of Linux terminal commands

Dokploy supports several Linux distributions, here we are using Ubuntu 24 for installing.

How to Install Dokploy on Ubuntu Server

Step 1: Connect to Your Server

Log in to your Ubuntu VPS using SSH.

ssh root@your-server-ip
Replace:
your-server-ip

with your actual server IP address.

Step 2: Update the Server

Before installing any software, update your system packages.

apt update && apt upgrade -y
This ensures your server has the latest security patches and package versions.

Step 3: Run the Dokploy Installation Script

Dokploy provides an automated installation script that handles the entire setup process.

Run:

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

The installer automatically performs several tasks:

  • Installs Docker
  • Configures Docker Swarm
  • Installs Traefik
  • Creates required containers
  • Sets up networking
  • Configures the Dokploy dashboard

Depending on server resources and internet speed, installation typically takes a few minutes.

Step 4: Verify Installation

After installation completes successfully, you should see an output similar to:

http://your-server-ip:3000

This indicates that the dashboard has been created successfully.

You can verify running containers with:

docker ps
Step 5: Access the Dokploy Dashboard

Open your web browser and navigate to:

http://your-server-ip:3000

You will be presented with the Dokploy setup wizard.

Complete the following:

  1. Create an administrator account
  2. Configure login credentials
  3. Set your deployment preferences
  4. Save the configuration

After setup, you can immediately begin deploying applications.

Common Installation Issues

Dashboard Not Loading

Possible causes:

  • Port 3000 blocked by firewall
  • Docker service not running
  • Installation incomplete

Check Docker status:

systemctl status docker
Port Conflicts

If ports 80, 443, or 3000 are already in use, Dokploy may fail to start.

Check active ports:

ss -tulpn

Stop conflicting services before re-running the installation.

Docker Installation Errors

Verify Docker installation:

docker --version

If Docker is not installed properly, rerun the installation script.

How Dokploy Works

Dokploy acts as a management layer above Docker and Docker Swarm.

Deployment Workflow

  1. Connect a Git repository
  2. Configure build settings
  3. Deploy application
  4. Traefik handles routing
  5. SSL certificates are generated automatically
  6. Application becomes publicly accessible

This workflow eliminates much of the manual configuration normally required for container deployments.

Securing Your Dokploy Installation

For production environments, security should be configured immediately after installation.

Use a Domain Name

Instead of accessing Dokploy via IP:

http://your-server-ip:3000

Configure a domain such as:

https://deploy.example.com

Enable HTTPS

Dokploy integrates with:

Let’s Encrypt

to automatically generate SSL certificates through Traefik.

Benefits include:

  • Encrypted traffic
  • Improved security
  • Better user trust
  • Compliance with modern browser requirements

Restrict Dashboard Access

Best practices include:

  • Use strong passwords
  • Enable firewall protection
  • Restrict dashboard exposure
  • Allow only trusted IP addresses when possible

Best Practices for Production Deployments

To ensure reliable application hosting:

  • Keep Ubuntu updated regularly
  • Monitor server resources
  • Back up deployment configurations
  • Use HTTPS for all applications
  • Enable automatic security updates
  • Monitor Docker container health
  • Remove unused containers and images

These practices help maintain performance and reduce security risks.

Conclusion

Installing Dokploy on Ubuntu Server is one of the fastest ways to create a self-hosted application deployment platform. With a single command, you can deploy Docker, Docker Swarm, Traefik, and the Dokploy dashboard, allowing you to manage applications from a centralized interface.

Whether you’re a developer, startup, or DevOps team, Dokploy provides a lightweight and cost-effective alternative to managed deployment platforms while giving you complete control over your infrastructure.

 

Picture of Merin John

Merin John

Liked!! Share the post.

Get Support right now!

Start server management with our 24x7 monitoring and active support team

Subscribe and get your first issue fixed for Free!

Looking for server support and 24x7 monitoring?

Have doubts? Connect with us now.