docker.recipes

Komodo Container Manager

beginner

Komodo modern Docker container management with built-in monitoring.

Overview

Komodo is a modern Docker container management platform built with Rust and TypeScript, created by mbecker20 to simplify container orchestration across multiple servers. Unlike traditional Docker management tools, Komodo combines container management with Git-based deployment workflows, real-time monitoring, and built-in build capabilities all through a single web interface. The platform eliminates the complexity of managing Docker containers across different environments by providing a centralized dashboard that connects to remote Docker hosts via secure API connections. This Komodo deployment creates a comprehensive container management hub that can orchestrate Docker containers not only on the local host but also on remote servers through secure connections. The system integrates directly with Git repositories to enable continuous deployment workflows, while providing real-time resource monitoring, log aggregation, and automated build processes. Komodo's architecture allows it to manage complex multi-container applications across different environments from a single control plane. This stack is ideal for DevOps teams managing multiple Docker hosts, small to medium businesses needing centralized container management, and developers who want GitOps-style deployments without the complexity of Kubernetes. Komodo bridges the gap between simple Docker Compose deployments and full container orchestration platforms, making it perfect for organizations that have outgrown manual Docker management but aren't ready for enterprise orchestration solutions.

Key Features

  • Multi-server Docker host management with secure remote connections
  • Git repository integration with automated pull-and-deploy workflows
  • Real-time container resource monitoring with CPU, memory, and network metrics
  • Built-in Docker image building from Git repositories with customizable build contexts
  • Live container log streaming with search and filtering capabilities
  • One-click container actions including start, stop, restart, and rebuild operations
  • Environment variable management with encrypted secret storage
  • Webhook support for automated deployments triggered by Git pushes

Common Use Cases

  • 1Managing Docker containers across multiple cloud instances or VPS servers
  • 2Implementing GitOps workflows for web applications and microservices
  • 3Centralizing container management for development and staging environments
  • 4Monitoring resource usage across distributed Docker deployments
  • 5Automating deployment pipelines for small to medium-sized applications
  • 6Replacing manual SSH-based container management with a web interface
  • 7Coordinating container updates across multiple production servers

Prerequisites

  • Docker Engine 20.10+ with Docker Compose V2 support
  • Minimum 1GB RAM available for Komodo container and data processing
  • Port 9120 available for the web interface (configurable)
  • Docker socket access for local container management (/var/run/docker.sock)
  • Git repositories accessible via HTTPS or SSH for deployment features
  • Network connectivity to any remote Docker hosts you plan to manage

For development & testing. Review security settings, change default credentials, and test thoroughly before production use. See Terms

docker-compose.yml

docker-compose.yml
1services:
2 komodo:
3 image: ghcr.io/mbecker20/komodo:latest
4 container_name: komodo
5 environment:
6 - KOMODO_HOST=http://localhost:9120
7 volumes:
8 - komodo_data:/data
9 - /var/run/docker.sock:/var/run/docker.sock
10 ports:
11 - "9120:9120"
12 restart: unless-stopped
13 networks:
14 - komodo-network
15
16volumes:
17 komodo_data:
18
19networks:
20 komodo-network:
21 driver: bridge

.env Template

.env
1# Komodo
2# No environment variables required

Usage Notes

  1. 1UI at http://localhost:9120
  2. 2Multi-server management
  3. 3Git repo deployment
  4. 4Real-time monitoring
  5. 5Build and deploy

Quick Start

terminal
1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4 komodo:
5 image: ghcr.io/mbecker20/komodo:latest
6 container_name: komodo
7 environment:
8 - KOMODO_HOST=http://localhost:9120
9 volumes:
10 - komodo_data:/data
11 - /var/run/docker.sock:/var/run/docker.sock
12 ports:
13 - "9120:9120"
14 restart: unless-stopped
15 networks:
16 - komodo-network
17
18volumes:
19 komodo_data:
20
21networks:
22 komodo-network:
23 driver: bridge
24EOF
25
26# 2. Create the .env file
27cat > .env << 'EOF'
28# Komodo
29# No environment variables required
30EOF
31
32# 3. Start the services
33docker compose up -d
34
35# 4. View logs
36docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

terminal
1curl -fsSL https://docker.recipes/api/recipes/komodo-docker-manager/run | bash

Troubleshooting

  • Komodo fails to start with 'permission denied' on docker.sock: Ensure the komodo container user has access to the Docker socket by adding the container to the docker group or adjusting socket permissions
  • Cannot connect to remote Docker hosts: Verify that remote hosts have Docker API enabled and accessible, check firewall rules for Docker daemon port (usually 2375/2376)
  • Git repository deployments fail with authentication errors: Configure SSH keys or personal access tokens in Komodo's credentials management section
  • Web interface shows 'connection refused' at localhost:9120: Check that the container is running and port mapping is correct, verify KOMODO_HOST environment variable matches your access URL
  • Container resource monitoring shows no data: Ensure Docker stats API is available and the komodo container has sufficient permissions to access Docker system information
  • Build processes fail with 'no space left on device': Clean up Docker build cache and ensure adequate disk space in the komodo_data volume

Community Notes

Loading...
Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

Includes docker-compose.yml, .env template, README, and license

Ad Space