Dokploy / Dokploy/dokploy

Custom and "private" Dokploy templates

Open
#2,414 6 comments 18 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
37.4k
Forks
3k
Avg merge
1d 3h
Merged PRs (30d)
73

Description

What problem will this feature address?

Currently the only way to take advantage of really useful features provided by Dokploy templates (template.toml) is by submitting one to the official templates repository. Which is fine, but those templates have to meet a certain standard and have somewhat useful use-case for others.

I believe there should be a way to create "private" templates for personal use. They are reusable with a ton of well thought out features such as "helpers" (https://github.com/Dokploy/templates?tab=readme-ov-file#helpers). It could be useful for personal projects when deploying to take advantage of "helpers" functionality.

Describe the solution you'd like

I am not too familiar with inner workings of Dokploy, but these are the alternatives of implementing I came up with:

  1. Probably the easiest method is to add an option for a custom endpoint to templates (https://github.com/Dokploy/templates). That way it could be self hosted and directly connect to Dokploy's UI.

  2. Allow deploying docker compose with template.toml directly from a git repo, similar to how it currently works but with template.toml support.

  3. Ability to add "helpers" functions inside .env files.

I would personally prefer self hosting templates because all of functionality is already there and because of ease of use since it's just a click of a button inside Dockploy's UI.

Describe alternatives you've considered

There aren't any alternatives to "helpers" functions because this is a Dokploy templates specific feature.

Additional context

No response

Will you send a PR to implement it?

Maybe, need help

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the Dokploy templates repository and the current template.toml integration. Compare the proposed custom endpoint, Git-based Docker Compose flow, and helpers in .env files, then clarify which approach should be implemented; done means users can create and reuse private templates through Dokploy's UI.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, git, typescript
Domain
devops
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.