From 33b72af6a0a158aba7c7fbb7b6584726e6a6bdfe Mon Sep 17 00:00:00 2001 From: John Date: Fri, 7 Nov 2025 02:09:41 +0000 Subject: [PATCH] updated readme to match current config --- README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 45 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index a8cad84..f903f53 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,29 @@ All nodes are managers providing a 4-node quorum (can tolerate 2 node failures w - **GlusterFS** mounted at `/home/doc/swarm-data/` on all nodes - Shared storage enables services to run on any node without storage constraints +## Directory Structure + +``` +swarm/ +├── conf/ # Traefik and service configurations +├── stacks/ +│ ├── apps/ # Application services +│ │ ├── adminer/ # Database management +│ │ ├── n8n/ # Workflow automation +│ │ ├── outline/ # Documentation wiki +│ │ ├── paperless/ # Document management +│ │ └── uptime/ # Uptime monitoring +│ ├── core/ # Core infrastructure +│ │ ├── authentik/ # SSO/Authentication +│ │ ├── portainer/ # Container management +│ │ └── traefik/ # Reverse proxy +│ ├── data/ # Data services +│ │ └── rsync/ # Backup service +│ └── web/ # Web services +│ └── tracker/ # Tracker site +└── README.md +``` + ## Service Distribution Strategy ### Pinned Services @@ -31,20 +54,36 @@ Services that can run on any node (swarm auto-balances): - adminer - authentik (server, worker, redis) - n8n +- outline - paperless (webserver, redis) - tracker-nginx - uptime-kuma -## Recent Changes (2025-10-30) +## Network Configuration -### Swarm Rebalancing +All services are connected to the `homelab` external overlay network for inter-service communication. + +### Local Deployment (2025-11-07) +- Services now use `.swarm.home` domains for local access +- TLS enabled without external certificate resolvers +- Simplified Traefik configuration for local development +- Removed Cloudflare DNS integration + +## Recent Changes + +### Local Configuration Update (2025-11-07) +- Migrated from external `.frostlabs.me` domains to local `.swarm.home` domains +- Updated Traefik labels across all services for local deployment +- Simplified `.gitignore` to exclude entire `conf/` directory +- Moved Authentik from `apps/` to `core/` directory structure +- Removed Traefik labels from n8n and paperless for direct access +- Updated Traefik stack configuration for simplified port bindings + +### Swarm Rebalancing (2025-10-30) - Promoted p1, p2, p3 from workers to managers - Removed unnecessary hostname constraints from service configs - Force-redeployed services to redistribute across all nodes - Verified GlusterFS accessibility on all nodes - -### Results - Achieved balanced workload distribution across all 4 nodes - Improved high availability with 4-node manager quorum -- Services now self-balance automatically when nodes fail/recover -- Fixed Portainer agent connectivity by restarting agents after manager promotion \ No newline at end of file +- Services now self-balance automatically when nodes fail/recover \ No newline at end of file