Skip to content

Commit 06f3bbb

Browse files
SiumauricioSiumauricio
committed
feat: enhance Dokploy documentation with cloud and multi-tenancy details
- Updated the cloud documentation to clarify the managed service model and its benefits. - Added a new section comparing Cloud vs Self-Hosted versions, detailing operational differences. - Introduced a comprehensive guide on multi-tenancy, explaining resource organization and access control. - Improved overall structure and clarity of the documentation for better user understanding.
1 parent 53250fd commit 06f3bbb

4 files changed

Lines changed: 441 additions & 5 deletions

File tree

‎apps/docs/content/docs/core/cloud.mdx‎

Lines changed: 72 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,85 @@ title: Dokploy Cloud
33
description: "Deploy your apps to multiple servers remotely without worrying about the underlying infrastructure."
44
---
55

6+
import { Callout } from 'fumadocs-ui/components/callout';
67

7-
Dokploy Cloud allows you to deploy your apps to a cloud provider of your choice. This means that you can deploy your apps to any cloud provider, such as AWS, GCP, Azure, or DigitalOcean, without having to worry about the underlying infrastructure.
8+
Dokploy Cloud is the managed version of Dokploy. Instead of installing and maintaining Dokploy on your own server, the **control plane** (UI, database, and management layer) is hosted by us — you just connect your own servers and deploy.
89

10+
## How it works
911

10-
By default when you install Dokploy in a Self Hosted version, if you deploy all your applications by default they will be deployed on the same server where Dokploy UI is installed. This means that you will need to build and run your applications where Dokploy
11-
UI is installed, which can be a challenge if you don't have the resources to do so, also self hosted support for remote instances.
12+
With **Self-Hosted** Dokploy, everything runs on a single server: the UI, the database (PostgreSQL), Redis, Traefik, and your applications — all on the same machine. This works well for small setups, but as you scale, your management layer competes for resources with your actual workloads.
1213

14+
**Dokploy Cloud** separates these concerns:
1315

14-
Dokploy cloud starts from $4.50 per month per server, the next is 3.50$, and you can deploy as many applications you want to your remote server connected to a dokploy cloud, multi server feature is recommended for HA and scalability projects.
16+
```
17+
┌──────────────────────────────┐ ┌─────────────────────────┐
18+
│ Dokploy Cloud │ │ Your Server(s) │
19+
│ (managed by Dokploy) │ │ (any cloud provider) │
20+
│ │ │ │
21+
│ ┌────────────┐ │ │ ┌───────────────────┐ │
22+
│ │ Dashboard │─── deploy ──┼──────►│ │ Your apps │ │
23+
│ │ (UI) │ │ │ │ Your databases │ │
24+
│ ├────────────┤ │ │ │ Your compose │ │
25+
│ │ PostgreSQL │ │ │ │ Traefik (proxy) │ │
26+
│ ├────────────┤ │ │ └───────────────────┘ │
27+
│ │ Redis │ │ │ │
28+
│ └────────────┘ │ │ ┌───────────────────┐ │
29+
│ │ │ │ Monitoring agent │ │
30+
│ ┌────────────┐ │◄──────┤ │ (metrics → cloud) │ │
31+
│ │ Monitoring │ │ │ └───────────────────┘ │
32+
│ └────────────┘ │ │ │
33+
└──────────────────────────────┘ └─────────────────────────┘
34+
```
1535

16-
You can start by registering on the [Dokploy Cloud](https://app.dokploy.com) website and follow the steps to deploy your apps, see the [Pricing](https://dokploy.com/pricing) page for more information.
36+
- **Control plane** (Cloud): Dashboard, user management, deployment orchestration, monitoring dashboard, and notifications.
37+
- **Data plane** (Your servers): Your actual applications, databases, Traefik, and a lightweight monitoring agent.
1738

39+
Your code and data **never leave your servers**. Dokploy Cloud only manages the orchestration.
1840

41+
## Key benefits
1942

43+
| Benefit | Description |
44+
|---------|-------------|
45+
| **No management overhead** | No need to maintain the Dokploy instance itself — updates, backups, and uptime are handled for you |
46+
| **100% server resources for your apps** | The UI and management database don't compete with your workloads |
47+
| **Multi-server from day one** | Connect as many servers as you need from any provider (AWS, GCP, Azure, DigitalOcean, Hetzner, etc.) |
48+
| **Automatic updates** | Always on the latest version of Dokploy without manual upgrades |
49+
| **Support** | Direct support via email/chat (Startup) or priority SLA (Enterprise) |
2050

51+
## Getting started
52+
53+
1. Register on [Dokploy Cloud](https://app.dokploy.com).
54+
2. Add a server by providing the SSH connection details (IP, port, SSH key).
55+
3. Dokploy Cloud will set up the server automatically (Docker, Traefik, monitoring agent).
56+
4. Start deploying your applications, databases, and compose stacks.
57+
58+
<Callout type="info">
59+
You can connect servers from **any provider** — they just need to be reachable via SSH. You can even mix providers (e.g., Hetzner for production, DigitalOcean for staging).
60+
</Callout>
61+
62+
## Pricing
63+
64+
Dokploy Cloud offers several plans:
65+
66+
| Plan | Price | Servers included | Additional servers |
67+
|------|-------|------------------|--------------------|
68+
| **Hobby** | $4.50/month per server | 1 | $4.50/month each |
69+
| **Startup** | $15/month | 3 | $4.50/month each |
70+
| **Enterprise** | Custom | Custom | Contact sales |
71+
| **Agency** | Custom | Custom | Contact partner team |
72+
73+
All plans include **unlimited deployments, databases, and applications** per server. Annual billing saves 20%.
74+
75+
See the [Pricing](https://dokploy.com/pricing) page for full plan details and feature limits.
76+
77+
## When to use Cloud vs Self-Hosted
78+
79+
| Use Cloud when... | Use Self-Hosted when... |
80+
|-------------------|------------------------|
81+
| You don't want to maintain the Dokploy instance | You want full control over everything |
82+
| You need multi-server from the start | You have a single server and want to keep it simple |
83+
| You want built-in monitoring without extra config | You already have your own monitoring stack |
84+
| You prefer automatic updates | You want to control when updates happen |
85+
| You need HA for the management layer | Budget is the top priority |
86+
87+
For a full feature comparison, see [Cloud vs Self-Hosted Differences](/docs/core/differences).

‎apps/docs/content/docs/core/differences.mdx‎

Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
---
2+
title: Cloud vs Self-Hosted
3+
description: "Detailed comparison between Dokploy Cloud and the Self-Hosted version."
4+
---
5+
6+
import { Callout } from 'fumadocs-ui/components/callout';
7+
8+
Both versions of Dokploy are **functionally identical** — same deployment engine, same features, same Docker/Traefik integration, same API. The difference is purely operational: **who manages the Dokploy instance itself**.
9+
10+
## Same features, different operations
11+
12+
Every feature available in Self-Hosted is also available in Cloud, and vice versa. This includes:
13+
14+
- Application, Database, and Docker Compose deployments
15+
- Git integration (GitHub, GitLab, Bitbucket, Gitea)
16+
- Traefik reverse proxy with custom domains & SSL
17+
- Remote servers and multi-server management
18+
- Monitoring, notifications, backups, rollbacks
19+
- Preview deployments, environments, templates
20+
- API & CLI, schedule jobs, watch paths
21+
- User permissions and all Enterprise features (SSO, custom roles, audit logs, whitelabeling)
22+
23+
There are **no feature gates** between Cloud and Self-Hosted. The core product is the same.
24+
25+
## What's actually different
26+
27+
The differences come down to three things:
28+
29+
### 1. Managed uptime
30+
31+
With **Self-Hosted**, you are responsible for keeping the Dokploy instance running. If your server goes down, restarts, or runs out of disk — you need to fix it yourself.
32+
33+
With **Cloud**, the Dokploy team manages the uptime of the control plane (the UI, database, and management layer). Your applications still run on your own servers, but the management dashboard is maintained by us.
34+
35+
### 2. Automatic updates
36+
37+
With **Self-Hosted**, you update Dokploy manually when new versions are released.
38+
39+
With **Cloud**, updates are applied automatically — you're always on the latest version without doing anything.
40+
41+
### 3. Support
42+
43+
With **Self-Hosted**, support is community-based (Discord, GitHub issues).
44+
45+
With **Cloud**, you get direct support depending on your plan:
46+
47+
| Plan | Support level |
48+
|------|--------------|
49+
| **Hobby** | Community (Discord) |
50+
| **Startup** | Email & Chat |
51+
| **Enterprise** | Priority support with SLA |
52+
53+
## Architecture
54+
55+
Both versions use the same architecture. The only difference is **where** the control plane runs.
56+
57+
### Self-Hosted
58+
59+
The Dokploy UI, PostgreSQL, Redis, and your applications all run on the same server(s) that you manage.
60+
61+
```
62+
┌─────────────────────────────────┐
63+
│ Your Server (you manage) │
64+
│ │
65+
│ Dokploy UI + PostgreSQL + Redis│
66+
│ Traefik (reverse proxy) │
67+
│ ───────────────────────────── │
68+
│ Your Apps & Databases │
69+
└─────────────────────────────────┘
70+
```
71+
72+
### Cloud
73+
74+
The control plane runs on Dokploy's infrastructure. Your servers only run your workloads.
75+
76+
```
77+
┌─────────────────┐ ┌──────────────────────┐
78+
│ Dokploy Cloud │ SSH │ Your Server(s) │
79+
│ (managed by us) │────────►│ Apps + Databases │
80+
│ │ │ Traefik │
81+
│ UI, DB, Redis │ └──────────────────────┘
82+
└─────────────────┘
83+
```
84+
85+
<Callout type="info">
86+
Your **applications keep running independently** even if the Cloud control plane is temporarily unavailable. The control plane is only needed for management operations (deploys, config changes, monitoring dashboard, etc.).
87+
</Callout>
88+
89+
## When to choose what
90+
91+
| Choose Self-Hosted if... | Choose Cloud if... |
92+
|--------------------------|-------------------|
93+
| You want zero cost | You don't want to maintain Dokploy itself |
94+
| You want full control over everything | You want automatic updates |
95+
| You prefer air-gapped or private networks | You want managed uptime for the control plane |
96+
| You're comfortable managing servers | You want direct support (Startup/Enterprise) |
97+
98+
## Cloud Plans
99+
100+
If you choose Dokploy Cloud, there are several plans depending on your needs:
101+
102+
### Plan comparison
103+
104+
| | Hobby | Startup | Enterprise | Agency |
105+
|---|:---:|:---:|:---:|:---:|
106+
| **Price** | $4.50/mo per server | $15/mo (3 servers included) | Custom | Custom |
107+
| **Additional servers** | $4.50/mo each | $4.50/mo each | Custom | Custom |
108+
| **Organizations** | 1 | 3 | Custom | Custom |
109+
| **Users** | 1 | Unlimited | Unlimited | Unlimited |
110+
| **Environments** | 2 | Unlimited | Unlimited | Unlimited |
111+
| **Backups** | 1 per app/database | Unlimited | Unlimited | Unlimited |
112+
| **Scheduled jobs** | 1 | Unlimited | Unlimited | Unlimited |
113+
| **RBAC** | Basic (Owner, Admin, Member) | Basic (Admin/Developer roles) | Fine-grained + custom roles | Fine-grained + custom roles |
114+
| **2FA** | ❌ | ✅ | ✅ | ✅ |
115+
| **SSO / SAML** | ❌ | ❌ | ✅ | ✅ |
116+
| **Audit logs** | ❌ | ❌ | ✅ | ✅ |
117+
| **White labeling** | ❌ | ❌ | ✅ | ✅ |
118+
| **Support** | Community (Discord) | Email & Chat | Priority with SLA | Partner team |
119+
120+
<Callout type="info">
121+
Annual billing saves **20%** on all plans. See the [Pricing](https://dokploy.com/pricing) page for the latest details.
122+
</Callout>
123+
124+
### Which plan do I need?
125+
126+
- **Hobby** — You're a solo developer deploying personal projects or small client sites on a single server.
127+
- **Startup** — You have a team, need multiple environments (production, staging, dev), and want unlimited backups and scheduled jobs.
128+
- **Enterprise** — You need SSO/SAML, audit logs, white labeling, custom roles with fine-grained permissions, and priority support with SLA.
129+
- **Agency** — You manage infrastructure for multiple clients and need a tailored partnership.

‎apps/docs/content/docs/core/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@
1515
"uninstall",
1616
"videos",
1717
"goodies",
18+
"multi-tenancy",
1819
"troubleshooting",
1920
"---Cloud---",
2021
"cloud",

0 commit comments

Comments
 (0)