dokploy: Instructions file for Codex

Universal Agent Standards

Version: 2.0.0
Last Updated: February 11, 2026
Project: Dokploy Open Source Templates with Cloudflare Services Integration

---

1. Quick Reference

Technology Stack

Layer	Tech	Version
Template Engine	docker-compose.yml + template.toml	TOML 0.5+
Language	TypeScript (meta.json generation)	5.0+
Container Orchestration	Docker Compose	3.8+
Service Mesh	Traefik (via Dokploy)	2.10+
Edge Services	Cloudflare Workers/Pages/D1/R2/KV	Latest
Package Manager	pnpm	8.0+

Project Structure

dokploy/
├── .github/
│   ├── copilot-instructions.md      # Primary Copilot config
│   ├── instructions/                # Path-specific instructions
│   ├── ISSUE_TEMPLATE/              # Issue templates
│   └── workflows/                   # GH Actions + gh-aw
├── .claude/
│   ├── commands/                    # Slash commands
│   └── skills/                      # Dokploy skills
├── blueprints/                      # Templates
│   └── [app-name]/
│       ├── docker-compose.yml
│       ├── template.toml
│       ├── [app].svg
│       └── README.md
├── meta.json                        # Template registry
├── AGENTS.md                        # This file
└── docs/                           # Extended docs

---

2. Template Anatomy

Minimal docker-compose.yml

version: "3.8"
services:
  app-name:
    image: org/image:1.0.0          # Pinned version
    restart: unless-stopped
    environment:
      - KEY=${VARIABLE_NAME}        # From template.toml
    volumes:
      - data:/path                  # Named volume

volumes:
  data: {}

# ❌ NO: ports, container_name, networks

Minimal template.toml

[variables]
main_domain = "${domain}"           # Dokploy helper
admin_password = "${password:32}"   # 32-byte random
cf_api_token = "${CF_API_TOKEN}"    # User env var

[config]
[[config.domains]]
serviceName = "app-name"            # MUST match compose
port = 3000
host = "${main_domain}"
path = "/"

[config.env]
ADMIN_PASSWORD = "${admin_password}"
CF_API_TOKEN = "${cf_api_token}"