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

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:

  1. Build your Docker image locally or in a CI/CD pipeline
  2. Push the image to Docker Hub or a private registry
  3. Configure Dokploy to authenticate with your registry if it’s private
  4. 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

Next Steps