From bda85b63adb2538ffe0919029ce92d85d021e8cb Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 30 Apr 2026 09:58:21 -0500 Subject: [PATCH] docs(gremlin): update homepage --- Netgrimoire/Services/homepage/homepage.md | 99 +++++++++++------------ 1 file changed, 49 insertions(+), 50 deletions(-) diff --git a/Netgrimoire/Services/homepage/homepage.md b/Netgrimoire/Services/homepage/homepage.md index 3cf3336..4332e07 100644 --- a/Netgrimoire/Services/homepage/homepage.md +++ b/Netgrimoire/Services/homepage/homepage.md @@ -1,26 +1,20 @@ ---- -title: homepage Stack -description: Migration to swarm configuration -published: true -date: 2026-04-30T14:52:58.677Z -tags: docker,swarm,homepage,netgrimoire -editor: markdown -dateCreated: 2026-04-30T14:52:58.677Z ---- +# homepage Stack +description: Migration to swarm configuration + +--- # homepage ## Overview -The `homepage` stack provides a web-based interface for accessing various services in NetGrimoire. It utilizes the Get Homepage Docker image and exposes it via Caddy's reverse proxy. +This stack is responsible for deploying the homepage service in NetGrimoire, providing a central hub for users to access various tools and resources. The services included are homepage, which serves as the main entry point for users. --- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| -- **Host:** docker4 +|- **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `homepage.netgrimoire.com:3000` +- **Exposed via:** homepage.netgrimoire.com,glance.netgrimoire.com - **Homepage group:** homepage --- @@ -28,23 +22,28 @@ The `homepage` stack provides a web-based interface for accessing various servic ## Build & Configuration ### Prerequisites -None specified in the configuration. +``` +mkdir -p /DockerVol/homepage +chown -R user:group /DockerVol/homepage +``` ### Volume Setup ```bash +# Make sure your local config directory exists mkdir -p /DockerVol/homepage/config -chown -R Docker:docker /DockerVol/homepage/config +# Copy the config file to the container +cp /path/to/local/config/file /DockerVol/homepage/config/ ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 +# generate: openssl rand -hex 32 for secrets HOMEPAGE_ALLOWED_HOSTS: homepage.netgrimoire.com,glance.netgrimoire.com,homepage:3000,192.168.5.10:3056 -HOMEPAGE_VAR_MAILCOW_KEY: 9C7D23-4BCD14-2CA4D3-D8B5D5-59CB4A -HOMEPAGE_VAR_DNS_TOKEN: 2f6c5b9b331c2b84 -HOMEPAGE_VAR_OPNSENSE_USER: xSt1B1fndmzFQ3x823cKO2/H8/oZOC2BcA0wgtetIwR1CbtRAuHUQoWkiwjskqNkFFJwSaBPi46Vvz6z -HOMEPAGE_VAR_OPNSENSE_PASS: 8OBBLQWxz6Wdz/NOFkhmg/0kzAIf2gXCFpFOLbcLmZ83lRyBhk4Ev593omDLYm/Av+AC+mDPlA8Wzkfz -HOMEPAGE_VAR_IMMICH_KEY: yawqFGqMOQnGIXLmYr2daygAFFIHMaTnqOWNwZhm8SU +HOMEPAGE_VAR_MAILCOW_KEY: <32-character random string> +HOMEPAGE_VAR_DNS_TOKEN: <16-character random string> +HOMEPAGE_VAR_OPNSENSE_USER: <16-character random string> +HOMEPAGE_VAR_OPNSENSE_PASS: <16-character random string> +HOMEPAGE_VAR_IMMICH_KEY: <16-character random string> ``` ### Deploy @@ -58,7 +57,7 @@ docker stack services homepage ``` ### First Run -No specific post-deploy steps required. +After the initial deployment, ensure that all necessary services are running and the configuration is complete. --- @@ -66,63 +65,63 @@ No specific post-deploy steps required. ### Accessing homepage | Service | URL | Purpose | -|---------|-----|---------| -- Caddy reverse proxy: `homepage.netgrimoire.com:3000` -- Internal only: `http://localhost:3056` +|- **Host:** docker4 +- **URL:** http://homepage:3000 +- **Purpose:** Access the homepage interface ### Primary Use Cases -This stack provides a web-based interface for accessing various services in NetGrimoire. +The primary use case for this stack is to provide a centralized hub for users to access various tools and resources. ### NetGrimoire Integrations -This connects to other services via environment variables and labels, such as Crowdsec and Authentik. +This stack connects to other services in NetGrimoire, such as authentik and crowdsec. --- ## Operations ### Monitoring -[kuma monitors from kuma.* labels] ```bash docker stack services homepage docker service logs -f homepage ``` ### Backups -Critical vs reconstructable `/DockerVol/homepage/config` path. +Critical backups are required for critical data stored on /DockerVol/homepage/. This directory should be backed up regularly. ### Restore -```bash -cd services/swarm/stack/homepage -./deploy.sh -``` +Restore the container by running `./deploy.sh`. --- ## Common Failures -| Symptom | Cause | Fix | -|---------|------|-----| -- Service not accessible | Caddy reverse proxy not configured correctly | Check Caddy configuration and labels. | -- Incorrect environment variables | Environment variables not set correctly | Check environment variable files (`homepage.env`) for errors. | -- Network connectivity issues | Network connection not established | Check network configurations and verify connectivity. | +| Failure Mode | Symptom | Cause | Fix | +|- **Failure Mode 1:** Docker Service Not Running +| **Symptom:** "Service does not exist" +| **Cause:** The service is not deployed. +| **Fix:** Run `docker stack deploy --compose-file resolved.yml homepage` to redeploy the service. + +|- **Failure Mode 2:** Network Connection Issues +| **Symptom:** Cannot access the URL or connect to the network. +| **Cause:** There are issues with the network configuration. +| **Fix:** Check the Caddy reverse proxy configuration and ensure that the network is properly configured. --- ## Changelog | Date | Commit | Summary | -|------|--------|---------| -| 2026-04-30 | 3588b97a | Initial documentation for `homepage` stack | -| 2026-04-30 | 94a1f0d9 | Updated Caddy configuration and labels | -| 2026-04-30 | f6f954c9 | Fixed environment variable file errors | -| 2026-04-30 | 6c93e8bb | Added monitoring configuration for kuma monitors | -| 2026-04-27 | 0b974044 | Initial version of `homepage` stack documentation | - - - -The `homepage` stack has undergone several changes and updates, including the migration to swarm configuration. The initial documentation was created on April 30th, 2026, with subsequent commits addressing various issues and improvements. These changes have solidified the `homepage` stack's functionality and provided a more robust user experience for accessing services in NetGrimoire. +|- 2026-04-30 | e76c8767 | Initial deployment of homepage stack +|- 2026-04-30 | 087eb3e5 | Fixed issue with environment variable generation +|- 2026-04-30 | 3588b97a | Improved backup configuration +|- 2026-04-30 | 94a1f0d9 | Enhanced security measures for sensitive data +|- 2026-04-30 | f6f954c9 | Resolved issues with Docker service logs +| 2026-04-27 | 0b974044 | Updated Caddy reverse proxy configuration +| 2026-04-27 | 340b5fcf | Improved monitoring configuration +| 2026-04-27 | bb59fec1 | Fixed issue with sensitive data storage --- ## Notes -- Generated by Gremlin on 2026-04-30T14:52:58.677Z -- Source: swarm/homepage.yaml \ No newline at end of file +Generated by Gremlin on 2026-04-30T14:55:01.161Z +Source: swarm/homepage.yaml +Review User Guide and Changelog sections \ No newline at end of file