v0.1
- Set HOMEPAGE_ALLOWED_HOSTS=* so Homepage accepts requests from localhost, LAN IPs, and Tailscale FQDNs (appropriate for demo) - Add host validation to docker-compose.yml.template and demo.env.template - Bootstrap HOMEPAGE_ALLOWED_HOSTS in ensure_env() for existing installs - Harden Playwright tests: check for "host validation failed" and "internal server error" text, verify page titles, use stronger content assertions based on actual rendered content - Pin @playwright/test to exact 1.52.0 (no caret) to prevent npm resolving to a version incompatible with the Docker image - Gitignore additional Homepage auto-generated files (custom.css/js, proxmox.yaml) 💘 Generated with Crush Assisted-by: GLM-5.1 via Crush <crush@charm.land>
TSYS Developer Support Stack
A Docker Compose-based multi-service stack of FOSS applications that run locally on developer workstations to enhance productivity and quality of life.
What It Does
Deploys 16 services across 4 categories via a single command:
| Category | Services |
|---|---|
| Infrastructure | Homepage (dashboard), Pi-hole (DNS), Dockhand (Docker management), Docker Socket Proxy |
| Monitoring | InfluxDB (time series), Grafana (visualization) |
| Documentation | Draw.io (diagramming), Kroki (diagrams as code) |
| Developer Tools | Atomic Tracker, ArchiveBox, Tube Archivist, Wakapi, MailHog, Atuin |
Quick Start
cd demo
cp demo.env.template demo.env
./scripts/demo-stack.sh deploy
Access the dashboard at http://localhost:4000
Credentials: admin / demo_password (demo only)
Requirements
- Docker Engine + Docker Compose
- 8GB RAM minimum
- 10GB disk space
- Linux (tested on Ubuntu)
Documentation
| Document | Purpose |
|---|---|
| demo/PRD.md | Product requirements (the source of truth) |
| demo/README.md | Full deployment and service documentation |
| demo/AGENTS.md | Development guidelines |
| AGENTS.md | Quick reference for contributors |
Testing
# Unit tests (no Docker required)
bash demo/tests/unit/test_env_validation.sh
# Full test suite (requires running stack)
./demo/scripts/demo-test.sh full
License
See LICENSE.
Languages
Markdown
100%