traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update manyfold

Browse source
This commit is contained in:
traveler 2026-04-28 15:13:20 -05:00
parent 4501e9a790
commit a31d226835
1 changed files with 32 additions and 46 deletions
Download patch file Download diff file Expand all files Collapse all files

78
Netgrimoire/Services/manyfold/manyfold.md
View file

@ -1,60 +1,44 @@
# manyfold Stack # manyfold
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 ## Overview
The Manyfold stack is a Docker Compose configuration for running the Manyfold application in NetGrimoire, utilizing Docker Swarm as the orchestration engine.
The manyfold stack is a NetGrimoire service that runs Manyfold, an AI-based platform for various applications.
--- ---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-------|-----|------|
| app | ghcr.io/manyfold3d/manyfold:latest | 3214 | Web App | - **Postgres:** docker4 | postgres:15 | 5432 | Database Server |
| postgres | postgres:15 | - | Database | - **Redis:** docker4 | redis:7 | | Cache Server |
| redis | redis:7 | - | Cache | - **Manyfold:** docker4 | ghcr.io/manyfold3d/manyfold:latest | 3214 | Application Server |
- **Host:** docker4 Exposed via: <http://caddy[netgrimoire]>, <http://localhost[netgrimoire]> (Internal only)
- **Network:** netgrimoire Homepage group: homepage.group
- **Exposed via:** <caddy://manyfold.app:3214> or Internal only
- **Homepage group:** homepage
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/manyfold mkdir -p /DockerVol/postgres db_data
chown -R manyfold:manyfold /DockerVol/manyfold chown -R postgres:postgres /DockerVol/postgres
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID=1000 PUID=1964
PGID=1000 PGID=1964
SECRET_KEY_BASE=a_nice_long_random_string SECRET_KEY_BASE=a_nice_long_random_string
DATABASE_ADAPTER=postgresql DATABASE_ADAPTER=postgresql
DATABASE_HOST=postgres DATABASE_HOST=postgres
DATABASE_PORT=5432 DATABASE_PORT=5432
DATABASE_USER=manyfold DATABASE_USER=manyfold
DATABASE_PASSWORD=F@lcon13 DATABASE_PASSWORD=F@lcon13
DATABASE_NAME=manyfold REDIS_URL=redis://redis:6379/1
``` ```
### Deploy ### Deploy
@ -68,7 +52,7 @@ docker stack services manyfold
``` ```
### First Run ### 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 ### Accessing manyfold
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
| app | <caddy://manyfold.app:3214> | Web App | - **Manyfold:** http://localhost[netgrimoire]
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
[kuma monitors: kuma.*
```bash ```bash
docker stack services manyfold docker stack services manyfold
docker-compose logs -f docker service logs -f manyfold | grep kuma.*
``` ```
### Backups ### Backups
Critical: /DockerVol/manyfold and reconstructable on demand. Critical data should be backed up on a persistent volume at /DockerVol/postgres.
### Restore ### Restore
Perform `./deploy.sh` to restore the stack from a previous snapshot. Restore from a backup by re-deploying the Manyfold stack.
--- ---
## Common Failures ## Common Failures
| Failure | Symptom | Cause | Fix | | Failure Mode | Symptom | Cause | Fix |
|---------|---------|------|-----| |-------------|---------|------|-----|
| CRASH | Application crash | Network issue | Restart service | - **Postgres Unavailable** | Service not responding. | No data available in Docker Vol. | Check the volume's existence and permissions.
| FAILURE | Database failure | Connection timeout | Update database connection parameters | - **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 | | 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. |
<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.> <Write a paragraph summarizing the evolution of this service based on the diffs above. The initial commit and recent file diff provided minimal changes, indicating that no significant updates were made beyond this point.>
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 ## 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 - Source: swarm/manyfold.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections