# Setup  Dokploy

**Dokploy** is an open-source application deployment and server management platform.\
It helps you easily deploy, monitor, and manage applications using Docker, without writing complex commands.\
It provides a modern web dashboard where you can manage containers, configure domains, enable SSL, and monitor your server.

**Key Features**

* **One-click app deployment** using Docker Compose, Dockerfile, Git, Registry, etc.
* **Built-in Traefik reverse proxy** with automatic HTTPS (Let’s Encrypt).
* **Self-hosted dashboard** for managing containers, domains, and certificates.
* **Centralized monitoring**, logs, and metrics.
* **Supports Docker & Docker Swarm mode** for multi-server clusters.
* **Automated backups** and database management (Postgres, Redis).

### **Steps to Install and Configure Dokploy on Ubuntu 22.04**

**Requirements and Prerequisites**

Before installing Dokploy, ensure the following conditions are met:

* A clean Ubuntu 22.04 server
* Root or sudo access
* Internet connectivity
* Domain name (optional but required for HTTPS)
* Ports **80**, **443**, and **3000** must be free and ufw allow.&#x20;

***

**STEP 1 — Install Docker**&#x20;

```
curl -fsSL https://get.docker.com | sudo bash
```

Start service:

```
sudo systemctl enable docker
sudo systemctl start docker
```

Check Docker Version

```
docker --version
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FCiHVBSsZczQO4wq19EAe%2Fimage.png?alt=media&#x26;token=4bd99da5-c408-465d-8924-4a509fedb0eb" alt=""><figcaption></figcaption></figure>

***

&#x20;**STEP 2 — Install Docker Compose**

```
sudo apt install docker-compose -y
```

Check Docker Compose Version

```
docker compose version
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FkL6W33PvzxOQcMF89oSX%2Fimage.png?alt=media&#x26;token=7ab4b550-a8c0-40d9-8310-824693a36eef" alt=""><figcaption></figcaption></figure>

***

**STEP 3 — Run Official Dokploy Installer (most important)**

This script auto-creates correct docker-compose.yml\
No need to manually write YAML now\
No need to guess images

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

This will install:

* Dokploy Traefik
* Dokploy API
* Dokploy App
* Redis
* Postgres
* All correct configs

***

**After installation completes**

The script displays a message in your terminal similar to:

```
Dokploy installation completed successfully!
Access your dashboard at: http://YOUR-SERVER-IP:3000
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FtEEDRgXw3crxUx1cRPCP%2Fimage.png?alt=media&#x26;token=6beb787a-7c85-4658-837a-d6b50618119e" alt=""><figcaption></figcaption></figure>

***

**STEP 4 — Check containers**

```
docker ps
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FIiJXDgXkRGnFqUR194XF%2Fimage.png?alt=media&#x26;token=8221cec0-28a0-4823-8461-b933a2fd3da7" alt=""><figcaption></figcaption></figure>

You MUST see:

* dokploy-traefik
* dokploy-postgres
* dokploy-redis
* dokploy
* dokploy-api

***

**STEP 5 — ACCESS DOKPLOY DASHBOARD**

Open:

```
http://<YOUR-IP>:3000
```

This will load the Dokploy login/setup page.

When you access Dokploy for the first time, you will see a setup page asking you to create an **Admin Account**.

This page contains three required fields:

* Name
* Email
* Password

Enter your details and click the **Create Account** button

Dokploy will save your details and automatically log you into the dashboard.

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2F0KUgVlKrymh1iht9lqCb%2Fimage.png?alt=media&#x26;token=1a94198a-b147-4726-89ca-20abfa579bf9" alt=""><figcaption></figcaption></figure>

Dokploy provides a library of ready-to-use templates that allow you to deploy popular open-source applications such as Adminer, Gitea, MySQL, PostgreSQL, Apprise API, BentoPDF, Firecrawl, and many others. You can filter templates by tags (e.g., databases, developer-tools) and deploy them instantly with one click.

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2F9JIJGapOZkhtxqTb3lai%2Fimage.png?alt=media&#x26;token=602fd222-2429-47bf-b675-ffbcc07393cf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2F4qL8EdSMxxKYRN2I2qXr%2Fimage.png?alt=media&#x26;token=428b058a-38d2-4613-b01f-2bc17e1e8b35" alt=""><figcaption></figcaption></figure>
