sencho

Self-hosted Docker Compose management platform. For single or multi-host compose-first workflow.

Automatically checked · GitHub checked 2026-11-12

Overview

Sencho

Self-hosted Docker Compose management for one machine or a fleet.

Docs · Tutorials · Website · Roadmap · Discussions · Sponsor · Buy Me a Coffee

Latest release Docker Pulls CI License


Sencho Home: a healthy fleet with stack health, recent alerts, and node heartbeat

What Sencho is

Sencho is a Docker Compose control plane for DevOps engineers, platform teams, system administrators and homelab users. It gives you a graphical interface for deploying, editing, watching and recovering Compose stacks, without giving up file-on-disk workflows: your compose files stay on the host and remain the source of truth.

It runs as a single container. To manage more machines, install Sencho on each one and connect them with an API token; the primary dashboard then proxies authenticated HTTP and WebSocket requests across your fleet. There is no SSH and no remote Docker socket, and nodes behind NAT can connect outbound with the Pilot Agent.

Sencho is free, open-source software under AGPLv3. Everything described here is included in the Community tier, with unlimited nodes and users.

Highlights

  • Your Compose files stay yours. Edit with a diff preview before you save, deploy, and roll back a bad deploy to the last good configuration. Stack management
  • Many machines, no SSH. One dashboard for every node, with Fleet view, remote updates and the Pilot Agent for hosts behind NAT. Multi-node
  • Deploys you can undo. Atomic deployments roll back on failure, and health-gated updates hold a rollout until your health checks pass.
  • Git-driven fleets. Sync stacks from a repository, roll out Blueprints across nodes, and see drift the moment a running stack stops matching its source. GitOps
  • Know what you run. Vulnerability scanning with Trivy, scan policies that can block a deploy, and Compose Doctor preflight checks. Security
  • Get back to working. A recovery guide for when Sencho, a deploy, sign-in, Docker or a node fails.

There is more: SSO and RBAC, alerts and notification routing, scheduled operations, a host console, an App Store, and a REST API. See the full feature guide.

Works with AI clients

sencho-mcp is a read-only Model Context Protocol server for your Sencho hub. An MCP client can ask about nodes, stacks, container health and update readiness through five observation tools. It uses an Observe Only token that cannot change anything, read secrets or open a shell. See the MCP server guide.


Quick start

Sencho talks to Docker through the host's /var/run/docker.sock. Mounting it grants Sencho the same privilege as sudo docker on the host, which is the model Portainer, Dockge and Komodo use too. See running with a non-root container user if you need stricter isolation.

services:
  sencho:
    image: saelix/sencho:latest
    container_name: sencho
    restart: unless-stopped
    ports:
      - "1852:1852"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      # 1:1 Compose Path Rule: the host path MUST match the container path
      - /opt/docker:/opt/docker
    environment:
      - COMPOSE_DIR=/opt/docker
      - DATA_DIR=/app/data
docker compose up -d

Open http://your-server:1852 and create your admin account. In production, put Sencho behind a TLS-terminating reverse proxy; the self-hosting guide covers hardening, environment variables and reverse-proxy examples.

Run with docker run instead
docker run -d --name sencho \
  -p 1852:1852 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v sencho_data:/app/data \
  # 1:1 Compose Path Rule: the host path MUST match the container path
  -v /opt/docker:/opt/docker \
  -e COMPOSE_DIR=/opt/docker \
  saelix/sencho:latest

For the full walkthrough, see the quickstart guide. To manage a second machine, install Sencho on it the same way and add it from the primary dashboard; see the multi-node guide.


Screenshots

Stack detail with live logs and the Anatomy panelFleet overview with three nodes
Security overview with scan summary and top findingsNetworking overview with exposure findings

Telemetry and data handling

Sencho does not emit telemetry, analytics, or crash reports, and makes no outbound calls to Sencho-controlled endpoints. Stack metadata, container inventory, and user activity never leave your instance. The web UI, including its typefaces, is served by the instance.

Admiral

Admiral is Studio Saelix's paid business assurance plan on top of everything in Community: Hardened Build, priority support, and governance depth such as LDAP / Active Directory and full audit log export. See sencho.io/pricing for current plan details.


Documentation, community, and license

Contributors