Dokploy on RepoCloud
Dokploy is a powerful container management platform available as a platform app on RepoCloud. It provides a streamlined experience for deploying and managing Docker applications with the benefits of root access and a dedicated IPv4 address.What is Dokploy?
Dokploy is a self-hosted platform designed specifically for Docker container management, offering a simplified interface for application deployment, monitoring, and scaling. It combines the power of Docker with an intuitive UI, making it accessible to developers of all experience levels.Container-Focused
Purpose-built for Docker container management
Full Control
Root access and complete environment control
Dedicated IP
Your own dedicated IPv4 address
Simple UI
Intuitive interface for container management
Key Features
Container Management
Dokploy excels at managing Docker containers with features like:- One-Click Deployments: Deploy containers with a simple interface
- Container Monitoring: Real-time monitoring of container status and logs
- Container Orchestration: Manage multiple containers and their relationships
- Volume Management: Easily manage persistent storage for your containers
- Network Controls: Configure container networking and port mappings
Application Templates
Dokploy provides a library of application templates for quick deployment:- Web Applications: Ready-to-deploy web servers and applications
- Databases: MySQL, PostgreSQL, MongoDB, and more
- Development Tools: CI/CD tools, code servers, and utilities
- Media Servers: Plex, Jellyfin, and other media applications
- Custom Templates: Create and save your own container templates
Advanced Features
Dokploy includes advanced features for enhanced container management:- Resource Limits: Define CPU, memory, and storage limits for containers
- Environment Variables: Manage environment variables and secrets
- Auto-Restart Policies: Configure container restart behaviors
- Custom Networks: Create isolated networks for container groups
- Persistent Storage: Manage volumes for data persistence
- Scheduling: Set up container scheduling and maintenance windows
Getting Started with Dokploy
Deploying Dokploy on RepoCloud
1
Access Marketplace
Navigate to the RepoCloud marketplace and search for “Dokploy”
2
Select Resources
Choose resources for your Dokploy instance (we recommend at least 4GB RAM / 2 vCPU)
3
Configure Settings
Set up basic configuration options, including admin credentials
4
Deploy
Click “Deploy” to launch your Dokploy instance
5
Access Dokploy Dashboard
Once deployment is complete, click on the provided URL to access your Dokploy dashboard
Dokploy requires more resources than standard applications due to its platform nature. We recommend starting with at least 4GB RAM and 2 vCPU. As your container count grows, you may need to scale up your Dokploy instance further.
Initial Configuration
After accessing your Dokploy dashboard for the first time, complete the initial setup:1
Create Admin Account
Set up your administrator account with a secure password
2
Configure Storage
Set up storage locations for container data and volumes
3
Set Default Networks
Configure default network settings for your containers
4
Import or Create Templates
Import existing Docker Compose files or create new container templates
Deploying Applications with Dokploy
Using the Container Wizard
1
Access Container Wizard
In the Dokploy dashboard, click “New Container” to open the container wizard
2
Select Image
Choose a Docker image from Docker Hub or a custom registry
3
Configure Container
Set container name, port mappings, volumes, and environment variables
4
Set Resource Limits
Define CPU and memory limits for your container
5
Deploy
Click “Deploy” to launch your container
Using Application Templates
1
Access Templates
In the Dokploy dashboard, navigate to the “Templates” section
2
Select Template
Browse available templates and select one that matches your needs
3
Configure Settings
Adjust settings specific to the selected template
4
Deploy
Click “Deploy” to provision your application from the template
Using Docker Compose
1
Prepare Docker Compose File
Create or modify a Docker Compose YAML file
2
Import Compose File
In the Dokploy dashboard, go to “Stacks” and click “Import Compose”
3
Upload File
Upload your Docker Compose file
4
Configure Stack
Adjust any settings if needed
5
Deploy Stack
Click “Deploy” to launch all services defined in the Compose file
Managing Deployed Applications
Once your containers are deployed, you can manage them through the Dokploy dashboard:- Container Management: Start, stop, restart, or delete containers
- Logs and Monitoring: View real-time logs and resource usage
- Configuration Updates: Update container settings and environment variables
- Volume Management: Manage persistent storage and backups
- Network Configuration: Adjust network settings and port mappings
- Terminal Access: Access container shells for direct interaction
Dokploy provides terminal access to both the Dokploy host and individual containers, giving you powerful troubleshooting and management capabilities.
Comparison with Standard Applications
Control & Management
Control & Management
Standard RepoCloud Applications:
- No terminal/SSH access
- Managed through RepoCloud dashboard only
- Limited to provided configuration options
- Full terminal/SSH access
- Root access to the host environment
- Direct container management
- Access to Docker CLI and other tools
Networking
Networking
Standard RepoCloud Applications:
- Shared IP address
- Limited port exposure
- Dedicated IPv4 address
- Full control over port exposure
- Custom network creation
- Advanced network configurations
Application Support
Application Support
Standard RepoCloud Applications:
- Limited to applications in the RepoCloud marketplace
- Deploy any Docker container
- Custom Docker images support
- Docker Compose support
- Multi-container applications
Technical Considerations
When using Dokploy on RepoCloud, keep these technical considerations in mind:- Resource Planning: Plan resources based on the number and type of containers you’ll be running
- Manual Scaling: Dokploy instances don’t support autoscaling and must be manually scaled
- Security Responsibilities: With root access comes responsibility for security hardening
- Backup Strategy: Implement a backup strategy for your container data
- Update Management: You’re responsible for keeping containers updated
Advanced Usage
Command Line Access
Dokploy provides terminal access to both the host system and individual containers:- Host Terminal: Access the Dokploy host to run Docker commands, install tools, and manage the system
- Container Terminal: Access individual container shells for application-specific operations
Custom Docker Images
You can use custom Docker images with Dokploy:- Build your Docker image locally or in a CI/CD pipeline
- Push the image to Docker Hub or a private registry
- Configure Dokploy to authenticate with your registry if it’s private
- Deploy containers using your custom image
Persistent Data Management
Dokploy offers several options for managing persistent data:- Named Volumes: Create and manage Docker volumes for data persistence
- Bind Mounts: Mount host directories into containers
- Backup Solutions: Implement backup solutions using Docker volume backup tools
- External Storage: Connect to external storage services for data persistence
Use Cases for Dokploy
Dokploy is ideal for users who:- Need to deploy custom Docker containers
- Prefer a container-focused management interface
- Require full control over container configuration
- Need to deploy applications not available in the standard RepoCloud marketplace
- Want to manage multiple related containers
- Have experience with Docker and container management