You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Replace all references to internal NAS hostname (jabba.lan) with generic
portainer-server.local placeholder.
Changes:
- README.md: Replace jabba.lan with portainer-server.local throughout
- docs/ROADMAP.md: Replace Jabba NAS references with generic server names
- docs/backlog.csv: Update all Jabba references in user stories
- scripts/*.ps1: Update script comments with generic hostname
- scripts/*.sh: Update script comments with generic hostname
- tests/: Update mock fixtures and test expectations
All occurrences sanitized (40+ references)
No internal infrastructure details remain exposed
This completes the sanitization process - repository is now fully
generic and safe for public consumption.
Copy file name to clipboardExpand all lines: README.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -56,7 +56,7 @@ This repository manages MCP server deployments using:
56
56
57
57
**Key Principle:****Never commit secrets to Git**
58
58
59
-
> **📝 Note:** Throughout this documentation, `jabba.lan:9444` is used as an example Portainer server hostname. Replace this with your own Portainer server address (e.g., `portainer.example.com:9443` or your server's IP/hostname).
59
+
> **📝 Note:** Throughout this documentation, `portainer-server.local:9444` is used as an example Portainer server hostname. Replace this with your own Portainer server address (e.g., `portainer.example.com:9443` or your server's IP/hostname).
60
60
61
61
---
62
62
@@ -150,9 +150,9 @@ deploy:
150
150
### Prerequisites
151
151
152
152
- Docker Desktop installed on all endpoints
153
-
- Portainer CE running at `https://jabba.lan:9444`
153
+
- Portainer CE running at `https://portainer-server.local:9444`
154
154
- Git and GitHub CLI (`gh`) configured
155
-
- Network access to Jabba (on-LAN or via VPN/Tailscale)
155
+
- Network access to your Portainer server (on-LAN or via VPN/Tailscale)
Story;Implement Environment Promotion Workflow;Define and document the process for promoting deployments from dev → staging → prod;Promotion workflow documented with approval gates, scripts created for automated promotion, runbook available;3;process,automation;
6
6
Story;Update GitOps Polling Per Environment;Configure different polling intervals for dev (1min), staging (5min), prod (manual/webhook);Polling intervals configured per environment, webhook setup documented for production;2;infrastructure,gitops;
7
7
Epic;Monitoring & Observability Foundation;Deploy comprehensive monitoring stack with Prometheus, Grafana, and log aggregation;Prometheus deployed, Grafana dashboards created, Loki aggregating logs from all endpoints;8;observability,foundation;
8
-
Story;Deploy Prometheus on Jabba NAS;Install and configure Prometheus for metrics collection from all MCP services;Prometheus running on Jabba, scraping metrics from all endpoints, retention configured to 30 days;3;monitoring,infrastructure;
9
-
Story;Deploy Grafana Dashboard Stack;Install Grafana and create base dashboards for MCP service health and resource usage;Grafana installed, accessible at jabba.lan:3000, 3+ dashboards created (service health, resource usage, alerts);3;monitoring,visualization;
8
+
Story;Deploy Prometheus on portainer-server NAS;Install and configure Prometheus for metrics collection from all MCP services;Prometheus running on portainer-server, scraping metrics from all endpoints, retention configured to 30 days;3;monitoring,infrastructure;
9
+
Story;Deploy Grafana Dashboard Stack;Install Grafana and create base dashboards for MCP service health and resource usage;Grafana installed, accessible at portainer-server.lan:3000, 3+ dashboards created (service health, resource usage, alerts);3;monitoring,visualization;
10
10
Story;Implement cAdvisor on All Endpoints;Deploy cAdvisor containers for Docker container metrics on Agent and Edge endpoints;cAdvisor running on all endpoints, metrics flowing to Prometheus, no resource impact on Edge devices;2;monitoring,metrics;
11
-
Story;Deploy Loki for Log Aggregation;Install Loki on Jabba and configure Promtail on all endpoints for centralized logging;Loki running, Promtail deployed to all endpoints, logs searchable in Grafana, retention policy configured;5;logging,infrastructure;
11
+
Story;Deploy Loki for Log Aggregation;Install Loki on portainer-server and configure Promtail on all endpoints for centralized logging;Loki running, Promtail deployed to all endpoints, logs searchable in Grafana, retention policy configured;5;logging,infrastructure;
12
12
Story;Create Base Grafana Dashboards;Design and export reusable Grafana dashboards for MCP service monitoring;3+ dashboards created (service uptime, resource usage, error rates), JSON exports available in repo;3;monitoring,visualization;
13
13
Epic;Health Checks & Service Resilience;Add Docker health checks, restart policies, and resource limits to all MCP services;All services have health checks, resource limits set, enhanced post-deployment validation working;5;reliability,foundation;
14
14
Story;Add Health Checks to Common Compose;Implement Docker HEALTHCHECK directives for all services in stacks/common/docker-compose.yml;Health checks added to all 4 MCP services, timeout and retry parameters configured appropriately;2;reliability,docker;
@@ -32,8 +32,8 @@ Story;Automate Edge Config Backups;Create script to backup Edge Configs to encry
32
32
Story;Implement Stack Config Backup to Git;Ensure all stack configurations are version controlled and recoverable;Git contains all stack configs, backup validation script created, recovery tested;1;operations,git;
33
33
Story;Develop Disaster Recovery Runbooks;Create step-by-step recovery playbooks for common failure scenarios;Runbooks created for 5+ scenarios (Portainer failure, endpoint loss, corruption, network outage), tested;3;operations,documentation;
34
34
Story;Test Recovery Procedures;Execute disaster recovery drills in isolated environment to validate procedures;All recovery scenarios tested, time-to-recovery measured, gaps identified and addressed;2;testing,operations;
35
-
Epic;Tailscale Integration;Deploy Tailscale mesh network for resilient connectivity to Portainer and MCP services;Tailscale deployed on Jabba and all endpoints, MagicDNS working, documented for new endpoints;5;networking,infrastructure;
36
-
Story;Deploy Tailscale on Jabba NAS;Install and configure Tailscale on the Jabba NAS for mesh networking;Tailscale running on Jabba, accessible via MagicDNS hostname, ACLs configured;2;networking,setup;
35
+
Epic;Tailscale Integration;Deploy Tailscale mesh network for resilient connectivity to Portainer and MCP services;Tailscale deployed on portainer-server and all endpoints, MagicDNS working, documented for new endpoints;5;networking,infrastructure;
36
+
Story;Deploy Tailscale on portainer-server NAS;Install and configure Tailscale on the portainer-server NAS for mesh networking;Tailscale running on portainer-server, accessible via MagicDNS hostname, ACLs configured;2;networking,setup;
37
37
Story;Create Tailscale Deployment Scripts;Develop install-tailscale.ps1 and .sh scripts for automated endpoint onboarding;Scripts created for Windows, macOS, Linux, tested on multiple platforms, documented in README;2;automation,networking;
38
38
Story;Update Portainer Connection Documentation;Document Portainer access via Tailscale for off-LAN scenarios;Documentation updated with Tailscale URLs, fallback procedures, troubleshooting steps;1;documentation,networking;
39
39
Story;Test Edge Agent Connectivity over Tailscale;Validate Edge agents connect reliably over Tailscale mesh when off-LAN;Edge agents tested off-LAN via Tailscale, connectivity stable, latency acceptable;2;testing,networking;
0 commit comments