Repository navigation
Add Komodo, Prometheus and other experiments; deprecate unused apps; document conventions - #20
Merged
Merged
Conversation
…document conventions New experiments: - komodo (core, periphery, bundled MongoDB) - prometheus with node-exporter, cadvisor, nut-exporter and an optional snmp-exporter, plus an example prometheus.yml with jobs for every app that exports metrics - laser-cutterd, unifi-occupancy, unifi-audit-daemon, library Changed: - grafana: open-source image, Postgres database, Prometheus network, Authentik OAuth settings in .env.example - vllm, llama-cpp, comfyui: networks and ports moved to docker-compose.networks.yml / docker-compose.ports.yml overlays, selected with COMPOSE_ACCESS in .env; COMPOSE_FILE assembled from per-choice parts Deprecated: statping, camera2prusa, homebox, influxdb, osticket, portainer, stable-diffusion-webui, telegraf, chronograf. Backups: remove the empty .rsync-exclude files and fix the workflow so it collects apps/*/.rsync.exclude and experiments/*/.rsync.exclude. Add AGENTS.md (with CLAUDE.md pointing to it) and a hackstack-app skill describing the repo's compose, .env, config and README conventions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…fixed names - Parse !override and !reset instead of failing with a YAML error. - Don't require restart, healthcheck or networks in docker-compose.<name>.yml overlays; those come from the base file they're merged onto. - Accept <app> and <app>-<service> as container_name/hostname, the naming AGENTS.md documents for multi-service apps. - Allow Komodo's bundled MongoDB (no shared MongoDB exists). - Mark the ports overlays with `# hackstack: ports required`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
New experiments
komodo: core, periphery and a bundled MongoDB. Komodo needs MongoDB, which the shared database services don't provide, so it bundles its own.prometheus: node-exporter, cadvisor, nut-exporter and an optional snmp-exporter. The exampleprometheus.ymlhas a commented-out job for every app inapps/andexperiments/that can export metrics.laser-cutterd: uses host networking because the Ruida controller replies to a fixed UDP port on the host. The README explains why.unifi-occupancy,unifi-audit-daemonandlibrary(pdxhackerspace/library).Changed
experiments/grafana: switched to the open-source image. It now uses the shared Postgres and joinsprometheus-net, and.env.examplehas Authentik OAuth settings.apps/vllm,apps/llama-cpp,experiments/comfyui: networks and ports moved out of the base compose file into new overlays,docker-compose.networks.ymlanddocker-compose.ports.yml.COMPOSE_ACCESSin.env.COMPOSE_FILEis now built from per-choice variables (hardware, storage, access).experiments/uptime-kuma: the commented-out influxdb network is removed.Deprecated (moved to
deprecated/): statping, camera2prusa, homebox, influxdb, osticket, portainer, stable-diffusion-webui, telegraf and chronograf. Prometheus and Grafana replace telegraf and chronograf.Backups
.rsync-exclude(dash) files.concatenate_rsync_exclude.yml:apps/*/.rsync.excludeandexperiments/*/.rsync.exclude.docs/contributing.md.Conventions
AGENTS.md(CLAUDE.mdpoints to it) and ahackstack-appskill. They cover the compose,.env,config/and README conventions:Notes for reviewers
.envfiles for vllm, llama-cpp and comfyui need the newCOMPOSE_HARDWARE/COMPOSE_ACCESS/COMPOSE_STORAGEblock from.env.example. vllm's default changes from a published port to the proxy networks.docker compose configfor every overlay combination of vllm, llama-cpp and comfyui (152 combinations), and withpromtool check configfor the example Prometheus config..rsync.excludewill be regenerated by the workflow after merge.prometheus-netbefore Prometheus can scrape it. That isn't done here.🤖 Generated with Claude Code
Note
Medium Risk
Large convention and compose refactor changes default LLM exposure and requires operator
.envmigration; new stacks add Docker-socket (Komodo) and host-network services with real deployment impact.Overview
Adds AGENTS.md (and CLAUDE.md / hackstack-app skill) as the canonical rules: deploy only via
.envandconfig/, overlays for structural choices, per-app.rsync.exclude, and shared DB conventions..github/scripts/validate_compose.pynow parses Compose merge tags, skips base-only rules on overlay files, allows Komodo’s bundled MongoDB, and relaxes hostname/name checks for multi-service apps.Backup aggregation is fixed: the workflow now collects
apps/**andexperiments/**per-app.rsync.excludefiles (correct trigger path, trailing-newline handling) and the root.rsync.excludeis rebuilt from real DB paths.vllm, llama-cpp, and comfyui stop baking in proxy networks or published ports in the base compose file. New
docker-compose.networks.ymlanddocker-compose.ports.ymloverlays are selected withCOMPOSE_ACCESS; hardware and NFS stay onCOMPOSE_HARDWARE/COMPOSE_STORAGE, withCOMPOSE_FILEassembled in.env.example. Default vllm access moves from a published port to Hackstack networks—existing.envfiles need updating.New experiments: Prometheus (exporters,
prometheus-net, example scrape jobs), Grafana (OSS image, shared Postgres,prometheus-net, richer.env.example), Komodo (core/periphery + MongoDB), library, laser-cutterd (host networking for Ruida UDP), unifi-occupancy / unifi-audit-daemon. uptime-kuma docs drop InfluxDB and point at deprecated/statping; statping is removed frombin/install-chaos.sh. Docs gain prometheus in the network reference and backup.rsync.excludeguidance.Reviewed by Cursor Bugbot for commit 92ee5c8. Bugbot is set up for automated code reviews on this repo. Configure here.