diff --git a/Netgrimoire/Services/manyfold/manyfold.md b/Netgrimoire/Services/manyfold/manyfold.md new file mode 100644 index 0000000..e9611ce --- /dev/null +++ b/Netgrimoire/Services/manyfold/manyfold.md @@ -0,0 +1,129 @@ +# 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 +--- + +## Overview + +The manyfold stack is a NetGrimoire service that runs Manyfold, an AI-based platform for various applications. + +--- + +## Architecture + +| Service | Image | Port | Role | +|---------|-------|------|------| +| app | ghcr.io/manyfold3d/manyfold:latest | 3214 | Web App | +| postgres | postgres:15 | - | Database | +| redis | redis:7 | - | Cache | + +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** or Internal only +- **Homepage group:** homepage + +--- + +## Build & Configuration + +### Prerequisites +No specific prerequisites are required for this stack. + +### Volume Setup +```bash +mkdir -p /DockerVol/manyfold +chown -R manyfold:manyfold /DockerVol/manyfold +``` + +### Environment Variables +```bash +generate: openssl rand -hex 32 +PUID=1000 +PGID=1000 +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 +``` + +### Deploy +```bash +cd services/swarm/stack/manyfold +set -a && source .env && set +a +docker stack config --compose-file manyfold-stack.yml > resolved.yml +docker stack deploy --compose-file resolved.yml manyfold +rm resolved.yml +docker stack services manyfold +``` + +### First Run +Perform `./deploy.sh` after deployment to initialize the database and populate it with data. + +--- + +## User Guide + +### Accessing manyfold +| Service | URL | Purpose | +|---------|-----|---------| +| app | | Web App | + +### Primary Use Cases +Use Manyfold for its AI-based features and applications. + +### NetGrimoire Integrations +This service connects to Postgres, Redis, and Caddy for data storage, caching, and reverse proxying respectively. + +--- + +## Operations + +### Monitoring +```bash +docker stack services manyfold +docker-compose logs -f +``` + +### Backups +Critical: /DockerVol/manyfold and reconstructable on demand. + +### Restore +Perform `./deploy.sh` to restore the stack from a previous snapshot. + +--- + +## Common Failures +| Failure | Symptom | Cause | Fix | +|---------|---------|------|-----| +| CRASH | Application crash | Network issue | Restart service | +| FAILURE | Database failure | Connection timeout | Update database connection parameters | + +--- + +## Changelog + +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-28 | 7088b84b | Migrated to swarm configuration. Added initial documentation. | + + + +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 +- Source: swarm/manyfold.yaml +- Review User Guide and Changelog sections \ No newline at end of file