Skip to content

Dokployfile.yml Concept & Template Generator #646

@dealenx

Description

@dealenx

Hey Dokploy team! 👋

My main goal is to make use of the functionality Templates in Dokploy are as simple and accessible as possible. Currently, the process of creating and sharing templates looks difficult in my opinion, so this slows down their distribution.

I wanted sharing the template to be as easy as linking to a GitHub repository

💡 The solution: Dokployfile.yml as an alternative to meta.json

I have developed the concept of a Dokployfile, which is a simple YAML manifest that lies in the repository next to your code. It works by analogy with package.json or Dockerfile: describes metadata, icons, and specifies the path to docker-compose and template.toml.

🛠 Live Generator
To demonstrate this, I built a tool that parses a Dokployfile from any public GitHub repository and instantly generates the Base64 data needed for Dokploy.

👉 Try the Live Generator here (This link generates a template from template)

👉 Template Example here

Example Dokployfile.yml:

version: "1"
meta:
  slug: "my-app"
  name: "My App"
  logo: "logo.svg" 
template:
  compose: "docker-compose.yml"
  config: "config.toml"

The concept is described in more detail in my repository: dealenx/Dokployfile.

Template view (Link):
Image

Template Generator view (Link):
Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions