From a31d2268359a86ede1e6815d0f777c6ab09c918f Mon Sep 17 00:00:00 2001 From: traveler Date: Tue, 28 Apr 2026 15:13:20 -0500 Subject: [PATCH] docs(gremlin): update manyfold --- Netgrimoire/Services/manyfold/manyfold.md | 78 ++++++++++------------- 1 file changed, 32 insertions(+), 46 deletions(-) diff --git a/Netgrimoire/Services/manyfold/manyfold.md b/Netgrimoire/Services/manyfold/manyfold.md index e9611ce..0287759 100644 --- a/Netgrimoire/Services/manyfold/manyfold.md +++ b/Netgrimoire/Services/manyfold/manyfold.md @@ -1,60 +1,44 @@ -# manyfold Stack - -description: Manyfold NetGrimoire service - ---- -title: manyfold Stack -published: true -date: 2026-04-28T20:11:03.785Z -tags: docker,compose,manyfold,netgrimoire -editor: markdown -dateCreated: 2026-04-28T20:11:03.785Z ---- +# manyfold ## Overview - -The manyfold stack is a NetGrimoire service that runs Manyfold, an AI-based platform for various applications. +The Manyfold stack is a Docker Compose configuration for running the Manyfold application in NetGrimoire, utilizing Docker Swarm as the orchestration engine. --- ## Architecture - | Service | Image | Port | Role | -|---------|-------|------|------| -| app | ghcr.io/manyfold3d/manyfold:latest | 3214 | Web App | -| postgres | postgres:15 | - | Database | -| redis | redis:7 | - | Cache | +|---------|-------|-----|------| +- **Postgres:** docker4 | postgres:15 | 5432 | Database Server | +- **Redis:** docker4 | redis:7 | | Cache Server | +- **Manyfold:** docker4 | ghcr.io/manyfold3d/manyfold:latest | 3214 | Application Server | -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** or Internal only -- **Homepage group:** homepage +Exposed via: , (Internal only) +Homepage group: homepage.group --- ## Build & Configuration - ### Prerequisites No specific prerequisites are required for this stack. ### Volume Setup ```bash -mkdir -p /DockerVol/manyfold -chown -R manyfold:manyfold /DockerVol/manyfold +mkdir -p /DockerVol/postgres db_data +chown -R postgres:postgres /DockerVol/postgres ``` ### Environment Variables ```bash -generate: openssl rand -hex 32 -PUID=1000 -PGID=1000 +# generate: openssl rand -hex 32 +PUID=1964 +PGID=1964 SECRET_KEY_BASE=a_nice_long_random_string DATABASE_ADAPTER=postgresql DATABASE_HOST=postgres DATABASE_PORT=5432 DATABASE_USER=manyfold DATABASE_PASSWORD=F@lcon13 -DATABASE_NAME=manyfold +REDIS_URL=redis://redis:6379/1 ``` ### Deploy @@ -68,7 +52,7 @@ docker stack services manyfold ``` ### First Run -Perform `./deploy.sh` after deployment to initialize the database and populate it with data. +No specific steps are required for the first run, as Docker Swarm will automatically detect and deploy all services. --- @@ -77,37 +61,40 @@ Perform `./deploy.sh` after deployment to initialize the database and populate i ### Accessing manyfold | Service | URL | Purpose | |---------|-----|---------| -| app | | Web App | +- **Manyfold:** http://localhost[netgrimoire] ### Primary Use Cases -Use Manyfold for its AI-based features and applications. +Use Manyfold to access and visualize your model libraries, with the option to upload new models directly from the application. ### NetGrimoire Integrations -This service connects to Postgres, Redis, and Caddy for data storage, caching, and reverse proxying respectively. +This stack connects to Postgres and Redis services, utilizing environment variables for communication. --- ## Operations ### Monitoring +[kuma monitors: kuma.* + ```bash docker stack services manyfold -docker-compose logs -f +docker service logs -f manyfold | grep kuma.* ``` ### Backups -Critical: /DockerVol/manyfold and reconstructable on demand. +Critical data should be backed up on a persistent volume at /DockerVol/postgres. ### Restore -Perform `./deploy.sh` to restore the stack from a previous snapshot. +Restore from a backup by re-deploying the Manyfold stack. --- ## Common Failures -| Failure | Symptom | Cause | Fix | -|---------|---------|------|-----| -| CRASH | Application crash | Network issue | Restart service | -| FAILURE | Database failure | Connection timeout | Update database connection parameters | +| Failure Mode | Symptom | Cause | Fix | +|-------------|---------|------|-----| +- **Postgres Unavailable** | Service not responding. | No data available in Docker Vol. | Check the volume's existence and permissions. +- **Redis Unavailable** | Service not responding. | No connection established to Redis server. | Ensure that Redis is running and accessible. +- **Manyfold Connection Failure**| Application unable to connect to Postgres or Redis. | No valid credentials provided for either service. | Correct and re-deploy the stack. --- @@ -115,15 +102,14 @@ Perform `./deploy.sh` to restore the stack from a previous snapshot. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | 7088b84b | Migrated to swarm configuration. Added initial documentation. | +| 2026-04-28 | d0611a95 | Initial documentation creation. | +| 2026-04-28 | 7088b84b | Updated service dependencies to match swarm/manyfold.yaml changes. | - - -The manyfold stack was recently migrated from a previous configuration to an improved swarm-based setup. This change enables better scalability and maintainability for the NetGrimoire service. The provided documentation now covers the essential aspects of the service's deployment, configuration, and usage. + --- ## Notes -- Generated by Gremlin on 2026-04-28T20:11:03.785Z +- Generated by Gremlin on 2026-04-28T20:11:06.959Z - Source: swarm/manyfold.yaml - Review User Guide and Changelog sections \ No newline at end of file