Installation

dockmesh runs as a single binary on any Linux host with Docker installed. No external dependencies required.

Quick install (recommended)

curl -fsSL https://get.dockmesh.dev | bash

This downloads the latest binary, installs it to /usr/local/bin/dockmesh, creates a systemd service, and starts it on port 8080.

Manual install

1. Download the binary

# AMD64 (most servers)
wget https://github.com/BlinkMSP/dockmesh/releases/latest/download/dockmesh-linux-amd64
chmod +x dockmesh-linux-amd64
mv dockmesh-linux-amd64 /usr/local/bin/dockmesh

# ARM64 (Raspberry Pi, Apple Silicon VMs)
wget https://github.com/BlinkMSP/dockmesh/releases/latest/download/dockmesh-linux-arm64
chmod +x dockmesh-linux-arm64
mv dockmesh-linux-arm64 /usr/local/bin/dockmesh

2. Create a systemd service

/etc/systemd/system/dockmesh.service

[Unit]
Description=dockmesh Container Management
After=network.target docker.service
Requires=docker.service

[Service]
Type=simple
ExecStart=/usr/local/bin/dockmesh
WorkingDirectory=/opt/dockmesh
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

3. Start

mkdir -p /opt/dockmesh
systemctl daemon-reload
systemctl enable --now dockmesh

4. Open the UI

Navigate to http://your-server:8080. The admin user is created on first boot — check the service logs for the initial password:

journalctl -u dockmesh | grep "bootstrap"

Docker install

docker run -d \
  --name dockmesh \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v dockmesh-data:/opt/dockmesh/data \
  -v /opt/dockmesh/stacks:/opt/dockmesh/stacks \
  ghcr.io/blinkmsp/dockmesh:latest

Requirements

• OS: Linux (amd64 or arm64)
• Docker: 20.10+ with API 1.41+
• Disk: ~50 MB for the binary + data
• Memory: ~30 MB base, scales with container count
• Ports: 8080 (HTTP), 8443 (agent mTLS, optional)

What’s next?

• Quick Start — deploy your first stack
• Configuration — environment variables and settings
• Multi-Host — add remote Docker hosts