Skip to content

docs: add Dokploy self-hosting guide#3082

Open
ChiragAgg5k wants to merge 5 commits into
mainfrom
docs/dokploy-self-hosting
Open

docs: add Dokploy self-hosting guide#3082
ChiragAgg5k wants to merge 5 commits into
mainfrom
docs/dokploy-self-hosting

Conversation

@ChiragAgg5k

Copy link
Copy Markdown
Member

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

  • New page: docs/advanced/self-hosting/platforms/dokploy — installation, domains & HTTPS, configuration (Assistant/SMS/SMTP/GitHub), and troubleshooting, following the structure of the Coolify guide.
  • Dokploy-specific guidance on wildcard certificates for site/function subdomains: Dokploy's built-in Let's Encrypt uses HTTP-01, which can't issue wildcards, so the page explains obtaining one via DNS-01 and adding it under Settings → Certificates.
  • Light/dark screenshot of the deployed Appwrite services (Containers tab).
  • Linked the new page from the self-hosting overview (PaaS cards + configuration section) and the sidebar nav.

Testing

  • Verified the guide's steps end to end on a live Dokploy v0.29.8 (Ubuntu) deployment: template deploy, function execution, static site deploy, and HTTPS on both exact and wildcard domains.
  • Markdoc structure validated (frontmatter, anchors, image blocks match existing self-hosting pages).

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

appwrite Bot commented Jul 3, 2026

Copy link
Copy Markdown

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Ready Ready View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Queued Queued View Logs Preview URL QR Code


Tip

Trigger functions via HTTP, SDKs, events, webhooks, or scheduled cron jobs

@greptile-apps

greptile-apps Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This 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 _APP_SMTP_SECURE=true value in the Coolify guide and wires the new page into the sidebar nav and overview cards.

  • New dokploy/+page.markdoc: Full walkthrough for template deployment, DNS/wildcard-cert setup (including a Cloudflare-specific callout), and configuration of Assistant, SMS, SMTP, and GitHub VCS env vars.
  • Coolify SMTP fix: _APP_SMTP_SECURE=true_APP_SMTP_SECURE=tls to match valid Appwrite values.
  • Image cache entries: Both new .avif screenshots are registered in .optimize-cache.json, consistent with the repo's convention of storing .png-keyed hashes for .avif files.

Confidence Score: 5/5

Documentation-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 _APP_SMTP_SECURE=tls) are technically correct. The previously flagged SMTP and GitHub VCS description issues have been addressed. The only remaining item is a minor brand-name capitalisation nit on one line.

No files require special attention.

Important Files Changed

Filename Overview
src/routes/docs/advanced/self-hosting/platforms/dokploy/+page.markdoc New Dokploy self-hosting guide; SMTP, wildcard cert, and GitHub VCS details are accurate, with one minor "Github" capitalisation nit on the final link.
src/routes/docs/advanced/self-hosting/platforms/coolify/+page.markdoc Fixed _APP_SMTP_SECURE=truetls to match valid Appwrite values.
.optimize-cache.json Added cache entries for both new Dokploy screenshot images (extension listed as .png vs actual .avif is intentional per repo convention).
src/routes/docs/advanced/self-hosting/+layout.svelte Added Dokploy entry to sidebar nav alongside Coolify.
src/routes/docs/advanced/self-hosting/+page.markdoc Added Dokploy PaaS card and updated the "Platform-as-a-Service" footer link.

Reviews (5): Last reviewed commit: "(fix): correct _APP_SMTP_SECURE value in..." | Re-trigger Greptile

@ChiragAgg5k

Copy link
Copy Markdown
Member Author

Rendered docs page (dark + light) — /docs/advanced/self-hosting/platforms/dokploy

rendered-dokploy-dark
rendered-dokploy-light

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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant