# Yacht Container Dashboard

> Lightweight Docker container management dashboard.

- Category: DevOps & CI/CD
- Difficulty: beginner
- Components: yacht
- Tags: yacht, docker, dashboard, lightweight, gui
- Source: https://docker.recipes/devops/yacht-docker-gui

## Overview

Yacht is a modern, web-based Docker container management dashboard developed by SelfHostedPro that prioritizes simplicity and ease of use over feature complexity. Originally created as a lightweight alternative to heavier container orchestration tools, Yacht focuses on providing essential Docker management capabilities through an intuitive web interface, making it particularly appealing for users who find traditional solutions overwhelming or resource-intensive. The platform emphasizes template-based deployments and includes a curated marketplace of application templates for quick container deployment.

This Yacht deployment creates a streamlined container management environment that connects directly to your Docker daemon through the Unix socket, providing real-time visibility and control over your containerized applications. The configuration establishes a secure network boundary while maintaining the low overhead that makes Yacht attractive for resource-constrained environments, small-scale deployments, and educational purposes.

This stack is ideal for homelab enthusiasts, small development teams, and system administrators who need straightforward Docker management without enterprise-grade complexity. Yacht excels in scenarios where you want visual container management capabilities but don't require advanced orchestration features, making it perfect for managing personal servers, development environments, or small business applications where simplicity and resource efficiency are priorities.

## Features

- Template marketplace with pre-configured application deployments for popular self-hosted services
- Real-time container monitoring with resource usage statistics and log streaming capabilities
- Visual container lifecycle management including start, stop, restart, and removal operations
- Docker Compose file import and export functionality for configuration portability
- Built-in application template editor for creating custom deployment configurations
- Multi-user authentication system with role-based access controls
- Container health monitoring with automatic status updates and failure notifications
- Image management interface for pulling, building, and organizing Docker images

## Use cases

- Homelab administrators managing multiple self-hosted services like media servers, automation tools, and network utilities
- Small development teams needing collaborative container management for shared development environments
- Educational environments teaching Docker concepts with an approachable visual interface
- Small business IT departments managing containerized applications without dedicated DevOps resources
- Remote server management where lightweight web-based access is preferred over CLI tools
- Prototyping and testing containerized applications using pre-built templates from the marketplace
- Personal cloud deployments requiring simple orchestration of multiple interconnected services

## Prerequisites

- Docker Engine 20.10 or newer with daemon socket accessible at /var/run/docker.sock
- Minimum 512MB RAM available for the Yacht container and managed applications
- Port 8000 available for web interface access or alternative port mapping configured
- User with UID/GID 1000 existing on host system for proper file permissions
- Basic understanding of Docker concepts including images, containers, and volume management
- Web browser with JavaScript enabled for accessing the management dashboard

## docker-compose.yml

```yaml
services:
  yacht:
    image: selfhostedpro/yacht:latest
    ports:
      - "8000:8000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - yacht_data:/config
    environment:
      - PUID=1000
      - PGID=1000
    networks:
      - yacht_net

volumes:
  yacht_data:

networks:
  yacht_net:
```

## .env

```bash
# Yacht
# Yacht at http://localhost:8000
# Default: admin@yacht.local / pass
```

## Usage notes

- Yacht at http://localhost:8000
- Default: admin@yacht.local / pass
- Template-based deployment
- Lightweight alternative to Portainer
- App templates marketplace

## Troubleshooting

- Permission denied accessing Docker socket: Ensure the user with PUID 1000 has Docker group membership or adjust PUID/PGID to match Docker socket permissions
- Yacht container fails to start with 'bind: address already in use': Change the host port mapping from 8000 to an available port like 8001:8000
- Cannot login with default credentials admin@yacht.local/pass: Reset the configuration by removing the yacht_data volume and restarting the container
- Template deployments fail with network errors: Verify yacht_net network creation and ensure containers can communicate within the isolated network
- Application templates not loading in marketplace: Check internet connectivity from Yacht container and verify no firewall restrictions on outbound HTTPS
- Container logs not displaying in Yacht interface: Confirm Docker daemon logging driver is set to json-file or journald rather than none

