dokploy-template-toml

Dokploy Template TOML

When to Use This Skill

• When creating template.toml for a new Dokploy template
• When configuring Dokploy variable generation (passwords, secrets)
• When setting up domain configuration for services
• When adding file mounts for configuration files
• When user asks about "dokploy variables" or "template configuration"

When NOT to Use This Skill

• When working with docker-compose only (no Dokploy)
• For runtime configuration changes (modify environment vars instead)

Prerequisites

• Completed docker-compose.yml file
• List of required/optional environment variables
• Domain configuration requirements
• Knowledge of secret generation needs

---

Template.toml Structure

# Header comment with application info
# Application Name - Description
# https://github.com/example/application

[variables]
# User-provided and auto-generated variables
domain = "${domain}"
secret_key = "${base64:64}"
password = "${password:32}"

# Domain configuration for Traefik
[[config.domains]]
serviceName = "app"
port = 3000
host = "${domain}"

# Environment variables for all services
[config.env]
APP_DOMAIN = "${domain}"
APP_SECRET = "${secret_key}"

# Optional file mounts
[[config.mounts]]
serviceName = "app"
mountPath = "/app/config.json"
content = """
{
  "setting": "${variable}"
}
"""

---

Core Patterns

Pattern 1: Variable Definitions

[variables]
# User-provided domain (required)
domain = "${domain}"

# Random password generation
db_password = "${password:32}"      # 32-char alphanumeric
api_key = "${password:48}"          # 48-char alphanumeric

# Base64 secret generation
secret_key = "${base64:64}"         # 64-char base64 encoded
jwt_secret = "${base64:32}"         # 32-char base64 encoded

# UUID generation
instance_id = "${uuid}"             # Random UUID v4

# User inputs
admin_email = "${email}"            # User-provided email
username = "${username}"            # User-provided username

# Derived variables (string concatenation)
app_url = "https://${domain}"
db_url = "postgresql://user:${db_password}@postgres:5432/db"