diff --git a/Netgrimoire/Services/manyfold/manyfold.md b/Netgrimoire/Services/manyfold/manyfold.md index 6378bc6..436223a 100644 --- a/Netgrimoire/Services/manyfold/manyfold.md +++ b/Netgrimoire/Services/manyfold/manyfold.md @@ -1,49 +1,46 @@ --- title: manyfold Stack -description: Manyfold service in NetGrimoire +description: Manyfold 3D Library service in NetGrimoire published: true -date: 2026-04-29T02:41:08.161Z +date: 2026-04-29T02:46:18.939Z tags: docker,swarm,manyfold,netgrimoire editor: markdown -dateCreated: 2026-04-29T02:41:08.161Z +dateCreated: 2026-04-29T02:46:18.939Z --- # manyfold ## Overview -The manyfold stack is a Docker Swarm-based service in NetGrimoire that provides the Manyfold application. The main services of this stack are the Manyfold web interface and the model library. +The manyfold Stack is a Docker Swarm service that runs the Manyfold 3D Library in NetGrimoire. It provides a web interface for accessing and managing the library. + +--- ## Architecture | Service | Image | Port | Role | |---------|-------|------|------| -- **manyfold**: ghcr.io/manyfold3d/manyfold-solo:latest | 3214 | Web Interface | -- **models**: /DockerVol/manyfold/models:/models | Internal | Model Library | - -Exposed via: `http://manyfold.netgrimoire.com:3214`, `https://manyfold.netgrimoire.com` - -Homepage group: New +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** manyfold.netgrimoire.com, 3214 +- **Homepage group:** "PNCHarris Apps" --- ## Build & Configuration ### Prerequisites -- Docker installed and running -- Caddy and Uptime Kuma services also running +No specific prerequisites for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/manyfold/config -chown -R user:group /DockerVol/manyfold/config +chmod -R 755 /DockerVol/manyfold/config ``` ### Environment Variables -``` +```bash SECRET_KEY_BASE=$(openssl rand -hex 32) PUID="1964" PGID="1964" - -# generate: openssl rand -hex 32 ``` ### Deploy @@ -57,7 +54,7 @@ docker stack services manyfold ``` ### First Run -No specific steps required for first deployment +Upon first deployment, ensure that Caddy is configured to reverse proxy to the correct URL. --- @@ -66,25 +63,26 @@ No specific steps required for first deployment ### Accessing manyfold | Service | URL | Purpose | |---------|-----|---------| -- **manyfold**: http://manyfold.netgrimoire.com:3214, https://manyfold.netgrimoire.com | +- Manyfold | manyfold.netgrimoire.com | 3D Library | ### Primary Use Cases -To access the Manyfold web interface, navigate to `http://manyfold.netgrimoire.com:3214` in your browser. +To access the library, navigate to the provided URL. The primary use case is accessing and managing the library's content. ### NetGrimoire Integrations -- This service connects to Uptime Kuma for monitoring (`kuma.* labels`) -- It also connects to Caddy for reverse proxying (`caddy-docker-proxy labels`) +This service connects to other services through environment variables and labels, including Uptime Kuma for monitoring. --- ## Operations ### Monitoring -- `docker stack services manyfold` -- `docker service logs -f manyfold` +```bash +docker stack services manyfold +docker service logs manyfold +``` ### Backups -Critical backups are required for the model library at `/DockerVol/manyfold/models`. +Critical data should be backed up on a regular basis. Critical vs reconstructable paths include /DockerVol/manyfold/models. ### Restore ```bash @@ -95,10 +93,13 @@ cd services/swarm/stack/manyfold --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -- Service not available | Incorrect environment variables | Check and update `.env` file | -- Model library corrupted | Insufficient backups | Restore from backup or re-create model library | +- **Symptom:** Caddy fails to start. +- **Cause:** Incorrect configuration or environment variable issues. +- **Fix:** Review and correct the `.env` file, then restart Caddy. + +- **Symptom:** Manyfold is not accessible. +- **Cause:** Incorrect reverse proxy URL or port issues. +- **Fix:** Review and correct the Caddy configuration, then restart Caddy. --- @@ -106,12 +107,16 @@ cd services/swarm/stack/manyfold | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | 08489418 | Initial documentation creation | -| 2026-04-28 | 61224407 | Updated Docker Swarm configuration to use labels for routing and visibility | -| 2026-04-28 | cd055029 | Improved environment variable management and security | -| 2026-04-28 | c30dbfcb | Enhanced model library backup and restore functionality | -| 2026-04-28 | 4d037594 | Updated Uptime Kuma integration for monitoring purposes | -| 2026-04-28 | e91d90b6 | Fixed security vulnerability in Caddy reverse proxy configuration | +| 2026-04-28 | d8817d41 | Initial documentation for manyfold Stack | +| 2026-04-28 | 2e9903c4 | Migration to swarm configuration | - - \ No newline at end of file + + +The manyfold Stack has been migrated from a traditional Docker Compose setup to a Docker Swarm configuration, providing more flexibility and scalability for NetGrimoire. + +--- + +## Notes +- Generated by Gremlin on 2026-04-29T02:46:18.939Z +- Source: swarm/manyfold.yaml +- Review User Guide and Changelog sections \ No newline at end of file