Sencho

A self-hosted Docker Compose management dashboard. Manage your stacks, containers, images, volumes, and networks through a modern web UI.

Features

• Stack Management — Create, edit, start, stop, and remove Docker Compose stacks with a built-in Monaco code editor
• Multi-Node Support — Manage remote Sencho instances through a transparent HTTP/WebSocket proxy (Distributed API model)
• App Store — One-click deployment from LinuxServer.io templates with editable ports, volumes, and environment variables
• Resource Hub — Browse and manage images, volumes, and networks with managed/external/unused classification
• Live Logs — Aggregated real-time log streaming across all containers with search and filtering
• Dashboard — Container stats, CPU/RAM metrics, health checks, and image update notifications
• Alerts — Configurable threshold alerts for CPU, RAM, and disk usage
• Terminal — In-browser host console and container exec via WebSocket

Quick Start

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

docker compose up -d

Then open http://your-server:3000 and create your admin account.

See the full documentation for configuration details, multi-node setup, and more.

Development

# Backend (Express + TypeScript)
cd backend && npm install && npm run dev

# Frontend (React + Vite)
cd frontend && npm install && npm run dev

The frontend dev server proxies /api requests to the backend on port 3000.

Contributing

See CONTRIBUTING.md for development setup and PR guidelines.

Security

See SECURITY.md for vulnerability reporting. Do not open public issues for security vulnerabilities.

License

License pending. See issue #100 for the license decision discussion and LICENSE for current status.