Repository navigation
Description
What problem will this feature address?
Currently, when sharing a direct link to a self-hosted Dokploy instance with a team on a messenger or team chat, it only shows a generic, unbranded preview. Dokploy does not render Open Graph tags (og:title, og:description, og:image), resulting in links missing proper context.
This lack of Open Graph metadata is a crucial missing feature for users who are purchasing a license to rebrand Dokploy as their private or internal infrastructure. Even when enterprise whitelabeling features are fully enabled, sharing a link to the dashboard still shows the exact same unbranded Dokploy link preview for everyone, breaking the white-labeling experience.
Describe the solution you'd like
I propose adding dynamic Open Graph metadata support that hooks directly into the existing Enterprise Whitelabeling system.
- Dynamic Metadata based on License/Whitelabeling:
- Enterprise users: Use the configured
Application Nameforog:titleandApplication Descriptionforog:description. - Default/Community: Render fallback placeholders:
- Title:
Dokploy - Description:
The Open Source alternative to Netlify, Vercel, Heroku.
- Title:
- Enterprise users: Use the configured
- New Whitelabeling Field for
og:image:- Add a new "OG Image URL" column next to the "Favicon URL" setting under
Dashboard > Settings > Whitelabeling. - Add a default
/og.pngimage for users who have not set a custom image or who are using the Community version.
- Add a new "OG Image URL" column next to the "Favicon URL" setting under
The implementation would require updating the JSONB default and Zod schema in @dokploy/server to include a nullable ogImageUrl, adding the frontend UI input, and conditionally rendering the <meta property="og:*"> tags in _document.tsx.
Describe alternatives you've considered
- Relying on the standard
<title>tag without OG tags, but modern team messengers (Slack, Discord, Teams) heavily rely on Open Graph for rich link previews. Without it, the links remain unbranded. - Hardcoding custom OG tags, but this breaks the ease of use of the Dokploy settings UI and doesn't solve it for all users dynamically.
Additional context
Open Questions for Maintainers: @Siumauricio and @narcisonunez
- Deprecating the
Page Titlefield: In/dashboard/settings/whitelabeling, thePage Titlefield underMetadata & Linksfeels redundant because users typically want the browser tab title and Open Graph title to simply mirror theApplication Nameset in the Branding section. Could we adapt the<title>andog:titleto just useApplication Namedirectly? - Renaming the section: If we remove
Page Titleand rely onApplication NameandApplication Descriptionfor all metadata (including OG), we could rename theMetadata & Linkssection to simplyLinks. This keeps all branding (Logo, Favicon, OG Image, Name, Description) consolidated cleanly in the Branding section.
Overall, these changes will make the user experience significantly better and more structured for an enterprise user. It also improves the default link previews for indie devs and small teams using the Community version, providing better marketing visibility for Dokploy itself when they share links.
Will you send a PR to implement it?
Yes. #5348
Activity
linear-code commentedon Sep 4, 2026
DOK-742