docs(gremlin): create manyfold

2026-04-28 15:12:11 -05:00 · 2026-04-28 15:12:11 -05:00 · 4501e9a790
commit 4501e9a790
parent c87b1db749
1 changed files with 129 additions and 0 deletions
--- a/Netgrimoire/Services/manyfold/manyfold.md
+++ 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:** <caddy://manyfold.app:3214> 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      | <caddy://manyfold.app:3214>        | 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. |
+
+<Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the 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