docs: add Dokploy self-hosting guide#3082
Conversation
Adds a Dokploy platform page under self-hosting, mirroring the Coolify guide (installation, configuration, troubleshooting) plus Dokploy-specific sections on domains/HTTPS and wildcard certificates for site and function subdomains. Includes a light/dark screenshot of the deployed Appwrite services, and links the new page from the self-hosting overview and sidebar.
Appwrite WebsiteProject ID: Website (appwrite/website)Project ID: Tip Trigger functions via HTTP, SDKs, events, webhooks, or scheduled cron jobs |
Greptile SummaryThis PR adds a Dokploy self-hosting guide that mirrors the structure of the existing Coolify page, covering installation, custom domains with wildcard certificates, environment variable configuration, and troubleshooting. It also fixes the incorrect
Confidence Score: 5/5Documentation-only change with accurate technical content; safe to merge. All changes are documentation and nav wiring. The wildcard-cert guidance, Cloudflare callout, and env-var values (including No files require special attention. Important Files Changed
Reviews (5): Last reviewed commit: "(fix): correct _APP_SMTP_SECURE value in..." | Re-trigger Greptile |
Regenerate the deployed-service screenshots through the repo image optimizer (bun run optimize) so both avif files have entries in .optimize-cache.json, matching every other docs image. Addresses Greptile review.
The _APP_VCS_GITHUB_* variables configure a GitHub App for deploying functions and sites from repositories (VCS integration), not console OAuth login. Corrects the misleading description. Addresses Greptile review.
The HTTPS section conflated single-host and wildcard domains. Now: main domains use Let's Encrypt; wildcard domains require a DNS-01-issued cert uploaded to Settings > Certificates AND their certificate provider set to None (the commonly-missed step, otherwise Traefik retries an impossible wildcard issuance). Adds a Cloudflare callout covering the second-level-wildcard edge-cert limitation and why Origin certs don't work.
_APP_SMTP_SECURE takes tls, ssl, or empty — not a boolean. Fixes the Dokploy guide and the pre-existing same error in the Coolify guide. Addresses Greptile review.




What
Adds a Dokploy platform guide under Self-hosting, alongside the existing Coolify page. Dokploy ships Appwrite as a one-click template, so this documents deploying and configuring it.
Changes
docs/advanced/self-hosting/platforms/dokploy— installation, domains & HTTPS, configuration (Assistant/SMS/SMTP/GitHub), and troubleshooting, following the structure of the Coolify guide.Testing