Repository navigation
π Initial Release
Complete Dokploy Application Server configuration with enterprise-grade architecture documentation.
β¨ Highlights
π Documentation (59 files, ~20,000 lines)
- β Complete TOGAF 9.2-compliant architecture documentation (21 documents)
- β MkDocs with Material theme and Mermaid diagram support
- β Getting started and quick start guides
- β Comprehensive troubleshooting guide
- β Auto-deployed to GitHub Pages
π§ Scripts & Automation
- β Traefik OVH DNS configuration script with automatic SSL
- β Documentation generation script
- β Taskfile with 50+ automation tasks
- β GitHub Actions workflow for CI/CD
ποΈ Architecture Coverage
- β All 8 TOGAF phases (A through H) documented
- β 3 Architecture Decision Records (ADRs)
- β 45+ Mermaid diagrams
- β 150+ code examples
- β Complete REST API specification
π» Technology Stack
- Orchestration: Docker Swarm
- Frontend: Next.js 14 with App Router, Material UI
- Backend: Node.js API routes, Prisma ORM
- Database: PostgreSQL 16 with JSONB, Row Level Security
- Cache: Redis 7 with BullMQ job queue
- Reverse Proxy: Traefik 3.6.1 with Let's Encrypt
- Authentication: JWT + OIDC support
π Documentation
- π Complete Architecture Documentation
- π Getting Started Guide
- π Traefik OVH DNS Setup
- βοΈ Task Automation Guide
π Quick Start
# Clone the repository
git clone https://github.com/brunseba/dokploy-application-server.git
cd dokploy-application-server
# Setup (requires Task: https://taskfile.dev/)
task setup
# Start documentation server
task docs:serve
# Configure Traefik with OVH DNS
task traefik:configureπ¦ What's Included
Documentation
docs/- Complete documentation sourcedocs/architecture/- TOGAF 9.2 architecture (21 documents)docs/getting-started.md- Detailed getting started guidedocs/quick-start.md- 10-minute quick startdocs/traefik-ovh-dns-setup.md- SSL configuration guide
Scripts
scripts/configure-traefik-ovh-dns.sh- Traefik OVH DNS configurationscripts/generate-docs.sh- Documentation generation
Configuration
mkdocs.yml- MkDocs configurationTaskfile.yml- Task automation (50+ tasks).github/workflows/docs.yml- GitHub Actions for docs deployment
π Statistics
| Category | Count |
|---|---|
| Total .md files | 59 |
| Architecture docs | 21 |
| Total lines | ~20,000+ |
| Mermaid diagrams | 45+ |
| Code examples | 150+ |
| Automation tasks | 50+ |
π― Use Cases
- Platform Engineers: Complete PaaS setup with automation
- DevOps Teams: Traefik SSL automation with OVH DNS
- Architects: TOGAF 9.2-compliant architecture reference
- Documentation Teams: MkDocs setup with Material theme
π€ Contributors
- Sebastien Brun - Initial work
- Warp AI Agent - Documentation and automation
π License
MIT License - see LICENSE file for details.
Documentation: https://brunseba.github.io/dokploy-application-server/
Repository: https://github.com/brunseba/dokploy-application-server
Issues: https://github.com/brunseba/dokploy-application-server/issues