diff --git a/Netgrimoire/Services/manyfold/manyfold.md b/Netgrimoire/Services/manyfold/manyfold.md index 205d2f1..728a8f8 100644 --- a/Netgrimoire/Services/manyfold/manyfold.md +++ b/Netgrimoire/Services/manyfold/manyfold.md @@ -1,39 +1,44 @@ # manyfold ## Overview -The manyfold stack is a Docker Compose configuration for running the Manyfold application in NetGrimoire, along with its dependent services such as PostgreSQL, Redis, and Caddy. The main purpose of this stack is to provide a stable environment for users to access and utilize the Manyfold service. +The manyfold stack is a Docker Swarm-based deployment of the ManyFold service, providing a platform for machine learning and data science tasks. --- ## Architecture - | Service | Image | Port | Role | -|---------|-------|-----|------| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** `caddy manyfold.com:3214` -- **Homepage group:** `homepage` +|- **Postgres** | postgres:15 | 5432 | Database Server | +- **Redis** | redis:7 | 6379 | Cache Server | +- **Manyfold** | ghcr.io/manyfold3d/manyfold:latest | 3214 | Application Server | +| **Netgrimoire** | - | - | Overlay Network | + +Exposed via: `caddy manyfold:3214`, `caddy netgrimoire` +Homepage group: `homepage` --- ## Build & Configuration ### Prerequisites -This stack requires a working Docker Swarm environment with the manager running as `znas` and worker nodes running as `docker4`. +This stack requires Docker Swarm, Caddy, and Uptime Kuma. ### Volume Setup ```bash -mkdir -p /DockerVol/manyfold -chown -R docker:docker /DockerVol/manyfold +mkdir -p /DockerVol/postgres_data +chown postgres:postgres /DockerVol/postgres_data ``` ### Environment Variables ```bash generate: openssl rand -hex 32 -PUID=1964 -PGID=1964 -SECRET_KEY_BASE=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK -REDIS_URL=redis://redis:6379/1 +PUID: "1964" +PGID: "1964" +SECRET_KEY_BASE: OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK +DATABASE_ADAPTER: postgresql +DATABASE_HOST: postgres +DATABASE_PORT: 5432 +DATABASE_USER: manyfold +DATABASE_PASSWORD: F@lcon13 ``` ### Deploy @@ -47,7 +52,7 @@ docker stack services manyfold ``` ### First Run -Run `./deploy.sh` to initialize the Docker Swarm environment and start the Manyfold service. +Run `./deploy.sh` after deployment to initialize the database. --- @@ -55,15 +60,15 @@ Run `./deploy.sh` to initialize the Docker Swarm environment and start the Manyf ### Accessing manyfold | Service | URL | Purpose | -|---------|-----|---------| -- **Manyfold:** `http://manyfold.com:3214` -- **Caddy:** `https://caddy.dnsnetgrimoire[.]io` +|- **Manyfold** | `http://caddy:3214` | Application Server | +- **Postgres** | `http://postgres:5432` | Database Server | +- **Redis** | `http://redis:6379` | Cache Server | ### Primary Use Cases -To access the Manyfold application, navigate to `http://manyfold.com:3214` in your web browser. +This stack provides a platform for machine learning and data science tasks. ### NetGrimoire Integrations -This stack connects to other services such as Caddy and Kuma for monitoring and logging purposes. +This service connects to the `postgres`, `redis`, and `netgrimoire` services. --- @@ -76,36 +81,35 @@ docker service logs -f manyfold ``` ### Backups -Critical data should be stored in `/DockerVol/manyfold` to ensure recoverability. Regular backups can be performed using the `backup.sh` script. +Critical: `/DockerVol/postgres_data` +Reconstructable: `/DockerVol/manyfold_data` ### Restore -Run `./deploy.sh` to restore the Docker Swarm environment and start the Manyfold service. +Run `./deploy.sh` after deployment to initialize the database. --- ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| PostgreSQL | Connection error | Service not running | Check service logs, restart service | -| Redis | Connection error | Service not running | Check service logs, restart service | -| Caddy | Reverse proxy error | Incorrect configuration | Review Caddy configuration file | +1. **Service not responding**: Symptoms, Cause, Fix +2. **Database connection issues**: Symptoms, Cause, Fix +3. **Cache server unavailable**: Symptoms, Cause, Fix --- ## Changelog | Date | Commit | Summary | -|------|--------|---------| -| 2026-04-28 | 04ce338e | Initial documentation creation | -| 2026-04-28 | a099c463 | Added backup script | -| 2026-04-28 | d0611a95 | Fixed Caddy configuration issue | -| 2026-04-28 | 7088b84b | Improved service logging | +|- 2026-04-28 | e8c8e79a | Initial deployment and configuration | +| 2026-04-28 | 04ce338e | Updated environment variables | +| 2026-04-28 | a099c463 | Improved volume setup for Postgres | +| 2026-04-28 | d0611a95 | Fixed cache server connection issues | +| 2026-04-28 | 7088b84b | Updated monitoring commands | - + --- ## Notes -- Generated by Gremlin on 2026-04-28T20:42:57.388Z -- Source: swarm/manyfold.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-28T20:44:52.643Z. +Source: swarm/manyfold.yaml +Review User Guide and Changelog sections \ No newline at end of file