mirror of
https://github.com/Studio-Saelix/sencho.git
synced 2026-08-07 09:24:09 +00:00
Anso
68a1dbe671
* chore(deps): upgrade ESLint 9 → 10 with plugin compatibility fixes - eslint: ^9 → ^10.0.0 (backend + frontend) - @eslint/js: ^9 → ^10.0.0 (backend + frontend) - eslint-plugin-react-refresh: ^0.4.24 → ^0.5.2 (ESM, config factory API) - Update frontend eslint.config.js: destructured import for react-refresh, call configs.vite() as factory function (0.5 API change) - Downgrade new ESLint 10 rules (no-useless-assignment, preserve-caught-error) to warnings for existing code patterns - eslint-plugin-react-hooks stays at 7.0.1 (stable) with --legacy-peer-deps until a stable release adds ESLint 10 peer support * chore(deps): upgrade recharts 2.x to 3.8 with chart.tsx type fixes recharts 3.x moved Tooltip/Legend props to context-based API. Updated chart.tsx to use explicit prop interfaces with internal recharts type imports (LegendPayload, TooltipPayload, TooltipFormatter). * chore(deps): upgrade TypeScript 5.9 to 6.0 - Remove deprecated baseUrl from frontend tsconfig (paths works standalone in TS 6) - Add react-is dependency required by recharts 3.x at build time - Backend and frontend both compile and lint cleanly * chore(deps): upgrade Vite 7.3 to 8.0 and @vitejs/plugin-react to 6.0 Vite 8 replaces Rollup+esbuild with Rolldown, significantly improving build speed (~2s vs ~18s). No config changes required. * fix(ci): add .npmrc with legacy-peer-deps for CI and Docker builds typescript-eslint@8.x requires typescript <6.0.0 and eslint-plugin-react-hooks@7.0.1 requires eslint <=9. Until upstream packages release compatible versions, legacy-peer-deps is needed. * docs: add logo assets and re-ignore CLAUDE.md * fix(ci): copy .npmrc into prod-deps Docker stage The prod-deps stage also runs npm ci with backend/package.json but was missing the .npmrc needed to bypass peer dep conflicts.
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.