Dokploy integrations: Settings → Integrations

Dokploy Community Edition is a self-hosted fork of Dokploy. It adds native integrations that you connect once per organization and then use from the pages of your services. This page covers each one: what it does, what you need, how to connect it, and its limits.

Integration What it gives you Where you connect it
Uptimely External uptime, SSL certificate and domain monitors for each service Settings → Integrations
Snapvisor Visual-diff review status on preview deployments Settings → Integrations
DoDomain Hosted flow for domain owners to connect DNS, with verification Settings → Integrations
Sendly Notification emails Settings → Notifications
Notifly Notification workflows Settings → Notifications

The Integrations page (/dashboard/settings/integrations) shows cards for Uptimely, DoDomain and Snapvisor. Each organization has one connection per product, so connecting again opens an edit instead. Secrets are write-only: after you save a key or token, Dokploy only shows its last four characters, and leaving the field blank while editing keeps the stored value. Every connect dialog has a Test connection button, so you can check the credentials before saving.

Uptimely: uptime, SSL and domain monitoring

Uptimely runs checks from outside your server. With the integration, each application, compose stack or database gets an opt-in uptime panel on its Monitoring tab: a status pill, a 30-day timeline per monitor, and a link to each monitor in Uptimely. Checks run every 5 minutes. Uptimely also publishes a Dokploy × Uptimely page that walks through the integration with screenshots.

What you need

How to connect

  1. Open Settings → Integrations and press Connect Uptimely.
  2. Fill in Name, Project API key and Project ID. You can leave Project ID blank and press Test connection: Dokploy lists the projects the key can reach and fills it in when there is exactly one.
  3. Leave Base URL at https://app.getuptimely.com unless you run a self-hosted Uptimely.
  4. Optionally set Status page slug. When it is set, the public status badge is shown on each monitored service. Only public status pages have a badge.
  5. Press Connect.

How to monitor a service

  1. Open the service and go to its Monitoring tab.
  2. In the Uptime by Uptimely panel, press Monitor with Uptimely. Nothing is created until you press it.
  3. For applications and compose stacks, tick Also add SSL certificate and domain monitors if you want them as well.
  4. For applications and compose stacks, optionally fill in Path to check (optional), for example /health. It is added to each domain’s URL, so pick a path that returns 200 (a 2xx or 3xx counts as up). Leave it blank to monitor the domain’s own URL. The path is only used when the monitors are first created.
  5. Below the path, the Reachability check makes a real request to each URL the monitors would watch and shows what it answers. A URL that answers an error or does not respond gets a warning that Uptimely will report it Offline, before any monitor exists. Press Check to run it again.
  6. Use Run probe now to run a check immediately, Add monitors for new domains after you add a domain (it creates a Website monitor for each HTTPS domain added since the service was linked and keeps the existing monitors), and Open in Uptimely to jump to a monitor.

What gets created

Limits to know about

Deploy heartbeat (applications and compose stacks)

The panel has an optional Deploy heartbeat. Press Add deploy heartbeat to create an Incoming Request monitor in Uptimely. After every successful deploy, Dokploy pings that monitor, so Uptimely alerts you when a service stops deploying on schedule.

Snapvisor: visual testing on preview deployments

Snapvisor diffs screenshots from your CI against a baseline and lets your team approve or reject the changes. With the integration, each preview deployment of an application shows the review status of its build.

What you need

How to connect

  1. Open Settings → Integrations and press Connect Snapvisor.
  2. Fill in Name, Personal access token and Account slug.
  3. Leave Base URL at https://api.snapvisor.io unless you run a self-hosted Snapvisor.
  4. Press Test connection, then Connect.

How to turn it on for an application

  1. Open the application, go to Preview Deployments and open the preview deployment settings.
  2. Under Visual testing (Snapvisor), pick the Snapvisor project. Off is the default.
  3. Each preview card now shows a Snapvisor badge: Pending, No changes, Changes detected, Approved, Rejected, Error or Expired, with a refresh button and a Review in Snapvisor link.

Branch and production deployments

The same link works for regular deployments. On the Deployments tab of an application or compose service, pick the Snapvisor project under Visual testing (Snapvisor) (it appears once Snapvisor is connected). Every finished deployment of that service that recorded its full commit SHA then shows the same badge, with a refresh button and a Review in Snapvisor link. A commit that has no build yet reads No build yet; an expired token, a rate limit or an unreachable Snapvisor reads Unavailable with the reason on hover. None of these affects the list. The commit is only trusted for git-sourced services (GitHub, GitLab, Bitbucket, Gitea, Git): for Docker-image, upload and raw-compose services the deployment text is free-form, so no badge or notification is produced from it.

Get notified when there are changes to review

Turn on Snapvisor Visual Changes on a notification channel (Settings → Notifications). When a deployment of a linked service, whether production, branch or preview, has a Snapvisor build for its commit and that build reaches Changes detected, the channel gets one message with the service, environment, branch, short commit, the number of changed snapshots and the review link.

Dokploy finds out by asking Snapvisor itself (outbound, every few minutes), so it works on a panel that Snapvisor cannot reach. A deployed commit is watched for 6 hours; if its build never appears or never needs a review, nothing is sent. Each commit of a service is announced at most once, even across restarts and redeploys of the same commit.

Limits to know about

DoDomain: custom-domain connect and DNS verification

DoDomain lets the owner of a domain connect it to your service through a hosted flow: one-click Cloudflare sign-in, Domain Connect with the DNS provider, or guided manual DNS setup. DoDomain verifies the records, and Dokploy asks DoDomain for the result on its own, so it works on a panel that is not reachable from the internet. If the panel is public, DoDomain’s webhooks add instant updates.

What you need

How to connect

  1. Open Settings → Integrations and press Connect DoDomain.
  2. Fill in Name, Secret key and App ID. You can leave App ID blank and press Test connection to fill it in from the key.
  3. Leave Base URL at https://app.dodomain.io unless you run a self-hosted DoDomain.
  4. Press Connect. The card shows that status is polled and whether the optional webhook is registered.

How to use it

  1. On a service’s Domains tab, add the domain the customer owns. In the domain dialog, Check DNS shows which provider hosts it and how its owner will connect.
  2. In the domain’s row, open the DoDomain actions menu and choose Send connect link. Dokploy shows the link, the DNS records it will request and when it expires. Copy connect link copies the active link and Check now asks DoDomain for the current state right away and shows the result.
  3. Send the link to the domain’s owner. Dokploy checks DoDomain every couple of minutes, and the domain row shows DNS verified once the records match. Until then it shows Awaiting domain owner, and DNS verification failed when the records no longer match. Verified domains are re-checked every 30 minutes, so a broken connection is noticed and sent to your notification providers.

Limits to know about

Sendly and Notifly: notification providers

Sendly and Notifly are notification providers, so they live in Settings → Notifications rather than on the Integrations page. Press Add Notification, then under Select a provider choose Sendly or Notifly. Choose which events should notify it, press Test Notification to send a test, then Create.

Sendly (sendly.now) sends notifications as email. Fields: Name, API Key, Base URL (defaults to https://app.sendly.now, the base URL of your Sendly instance), From Address and one or more To Addresses.

Notifly (notifly.io) triggers a Notifly workflow for each notification. Fields: Name, API Key, Base URL (defaults to https://api.notifly.io), Workflow Key (the identifier of the workflow to trigger) and an optional Subscriber ID that defaults to dokploy.

Uptimely (getuptimely.com) is also a provider. Choose Uptimely under Select a provider. When a deploy fails it declares an incident in the Uptimely project, and the next successful deploy of the same service resolves it. Fields: Name, API Key, Project ID, Base URL (defaults to https://app.getuptimely.com) and an optional Resolved state ID. It only reacts to the App Build Error switch (a success always resolves an open incident).