mrcharles
92a0fd76cb
Kiwix was failing to start: its inline bootstrap command had a shell
syntax error (a YAML-wrapped multi-line wget left a dangling `||`), and
the hard-coded sample-ZIM URL returned 404 because Kiwix rotates the
date-stamped filenames monthly.
Replace the inline command with a bind-mounted bootstrap script that
resolves the current ZIM filename from the Kiwix OPDS catalog at startup,
so the download URL never rots. kiwix-serve is also started on port 8080
to match the container port mapping and healthcheck (it defaults to 80).
💘 Generated with Crush
Assisted-by: Crush:glm-5.2
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 24 services across 6 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), Metrics (GitHub metrics), Apple Health (health data) |
| Documentation | Draw.io (diagramming), Kroki (diagrams as code), Kiwix (offline wiki) |
| Developer Tools | Atomic Tracker, ArchiveBox, Tube Archivist, Wakapi, MailHog, Atuin |
| Productivity | Reactive Resume (resume builder), Resume Matcher (AI resume screening) |
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.