Yacht Container Dashboard

beginner

Lightweight Docker container management dashboard.

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.

Key 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

Common Use Cases

1Homelab administrators managing multiple self-hosted services like media servers, automation tools, and network utilities
2Small development teams needing collaborative container management for shared development environments
3Educational environments teaching Docker concepts with an approachable visual interface
4Small business IT departments managing containerized applications without dedicated DevOps resources
5Remote server management where lightweight web-based access is preferred over CLI tools
6Prototyping and testing containerized applications using pre-built templates from the marketplace
7Personal 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

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

docker-compose.yml

1services: 
2  yacht: 
3    image: selfhostedpro/yacht:latest
4    ports: 
5      - "8000:8000"
6    volumes: 
7      - /var/run/docker.sock:/var/run/docker.sock
8      - yacht_data:/config
9    environment: 
10      - PUID=1000
11      - PGID=1000
12    networks: 
13      - yacht_net
14
15volumes: 
16  yacht_data: 
17
18networks: 
19  yacht_net:

.env Template

.env

1# Yacht
2# Yacht at http://localhost:8000
3# Default: admin@yacht.local / pass

Usage Notes

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

Quick Start

terminal

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  yacht:
5    image: selfhostedpro/yacht:latest
6    ports:
7      - "8000:8000"
8    volumes:
9      - /var/run/docker.sock:/var/run/docker.sock
10      - yacht_data:/config
11    environment:
12      - PUID=1000
13      - PGID=1000
14    networks:
15      - yacht_net
16
17volumes:
18  yacht_data:
19
20networks:
21  yacht_net:
22EOF
23
24# 2. Create the .env file
25cat > .env << 'EOF'
26# Yacht
27# Yacht at http://localhost:8000
28# Default: admin@yacht.local / pass
29EOF
30
31# 3. Start the services
32docker compose up -d
33
34# 4. View logs
35docker 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/yacht-docker-gui/run | bash

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

Community Notes

Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

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

Components

yacht

Related Recipes

Ad Space

Shortcuts: C CopyF FavoriteD Download