Core functionality is working and tested.

Creates development workspaces on your Dokploy server that you can connect to with DevPod. Think of it as your personal cloud development environment that automatically sets up everything you need.

DevPod → Dokploy Provider → Docker Compose Service → SSH Access → Your Code

1. Creates infrastructure: Spins up Docker Compose services in Dokploy
2. Sets up SSH: Configures secure root access to containers
3. Installs DevPod agent: DevPod connects and sets up your dev environment
4. Ready to code: Open in VS Code, clone repos, install dependencies automatically

• ✅ Docker Compose services - Uses Dokploy's stable service infrastructure
• ✅ SSH setup - Automatic port mapping and authentication
• ✅ DevPod integration - Full workspace lifecycle support
• ✅ Docker-in-Docker - Complete container development capabilities
• ✅ Git repositories - Clone and develop any repository
• ✅ Go binary helper - Fast operations instead of slow shell scripts

• DevPod installed locally
• Dokploy server with API access
• API token with project creation permissions

⚠️ Note: We currently do not offer backward compatibility. Always use the exact versions listed above for the best experience. Newer versions may work but are not guaranteed to be compatible until tested and updated here.

# Clone and build
git clone https://github.com/your-org/dokploy-devpod-provider
cd dokploy-devpod-provider
make build
make install-dev

devpod provider set-options dokploy-dev \
  DOKPLOY_SERVER_URL=https://your-dokploy-server.com \
  DOKPLOY_API_TOKEN=your-api-token

# From a Git repository
devpod up https://github.com/microsoft/vscode-remote-try-node --provider dokploy-dev

# From a Docker image
devpod up ubuntu --provider dokploy-dev

Note: DevPod automatically manages agent installation, credentials injection, and auto-shutdown features.

# Build binary
make build

# Install as development provider
make install-dev

# Test different scenarios
make test-git      # Test Git repository
make test-docker   # Test Docker image
make test-lifecycle # Full create/delete cycle

# Clean up stuck workspaces
make force-uninstall

The provider creates workspaces with a 4-stage setup (~2-4 minutes):

1. Docker daemon startup (~30-60 seconds)
2. Install SSH server + tools (~30-60 seconds)
3. Configure SSH for root user (~10-20 seconds)
4. Finalize SSH daemon (~10-20 seconds)

• Base Image: cruizba/ubuntu-dind:latest (Docker-in-Docker)
• SSH Authentication: Root access with key injection
• Port Range: 2222-2250 for SSH mappings
• API Integration: Dokploy REST API for service management

• Only tested on a few setups - might break in other environments
• SSH setup is slow (2-4 minutes)
• Port range is hardcoded (2222-2250)
• Error handling could be better
• No resource limits on containers
• Limited debugging tools

This is a prototype that needs work! Help is welcome:

• 🧪 Test on different environments - Try it on your setup
• 📝 Improve error messages - Make failures clearer
• 🐛 Fix edge cases and bugs - There are definitely some
• 📚 Write better documentation - Always room for improvement

See CONTRIBUTING.md for development details.

MIT License - feel free to use this however you want.

• DevPod for the amazing development environment platform
• Dokploy for the deployment infrastructure
• Docker for making containers awesome
• cruizba/ubuntu-dind for the excellent Ubuntu Docker-in-Docker base image
• STACKIT DevPod Provider for the amazing provider codebase