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 21:47:34 -05:00
parent fda23f4bee
commit 1e92b784f3
1 changed files with 41 additions and 36 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,49 +1,46 @@
---
title: manyfold Stack
description: Manyfold service in NetGrimoire
description: Manyfold 3D Library service in NetGrimoire
published: true
date: 2026-04-29T02:41:08.161Z
date: 2026-04-29T02:46:18.939Z
tags: docker,swarm,manyfold,netgrimoire
editor: markdown
dateCreated: 2026-04-29T02:41:08.161Z
dateCreated: 2026-04-29T02:46:18.939Z
---
# manyfold
## Overview
The manyfold stack is a Docker Swarm-based service in NetGrimoire that provides the Manyfold application. The main services of this stack are the Manyfold web interface and the model library.
The manyfold Stack is a Docker Swarm service that runs the Manyfold 3D Library in NetGrimoire. It provides a web interface for accessing and managing the library.
---
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **manyfold**: ghcr.io/manyfold3d/manyfold-solo:latest | 3214 | Web Interface |
- **models**: /DockerVol/manyfold/models:/models | Internal | Model Library |
Exposed via: `http://manyfold.netgrimoire.com:3214`, `https://manyfold.netgrimoire.com`
Homepage group: New
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** manyfold.netgrimoire.com, 3214
- **Homepage group:** "PNCHarris Apps"
---
## Build & Configuration
### Prerequisites
- Docker installed and running
- Caddy and Uptime Kuma services also running
No specific prerequisites for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/manyfold/config
chown -R user:group /DockerVol/manyfold/config
chmod -R 755 /DockerVol/manyfold/config
```
### Environment Variables
```
```bash
SECRET_KEY_BASE=$(openssl rand -hex 32)
PUID="1964"
PGID="1964"
# generate: openssl rand -hex 32
```
### Deploy
@ -57,7 +54,7 @@ docker stack services manyfold
```
### First Run
No specific steps required for first deployment
Upon first deployment, ensure that Caddy is configured to reverse proxy to the correct URL.
---
@ -66,25 +63,26 @@ No specific steps required for first deployment
### Accessing manyfold
| Service | URL | Purpose |
|---------|-----|---------|
- **manyfold**: http://manyfold.netgrimoire.com:3214, https://manyfold.netgrimoire.com |
- Manyfold | manyfold.netgrimoire.com | 3D Library |
### Primary Use Cases
To access the Manyfold web interface, navigate to `http://manyfold.netgrimoire.com:3214` in your browser.
To access the library, navigate to the provided URL. The primary use case is accessing and managing the library's content.
### NetGrimoire Integrations
- This service connects to Uptime Kuma for monitoring (`kuma.* labels`)
- It also connects to Caddy for reverse proxying (`caddy-docker-proxy labels`)
This service connects to other services through environment variables and labels, including Uptime Kuma for monitoring.
---
## Operations
### Monitoring
- `docker stack services manyfold`
- `docker service logs -f manyfold`
```bash
docker stack services manyfold
docker service logs manyfold
```
### Backups
Critical backups are required for the model library at `/DockerVol/manyfold/models`.
Critical data should be backed up on a regular basis. Critical vs reconstructable paths include /DockerVol/manyfold/models.
### Restore
```bash
@ -95,10 +93,13 @@ cd services/swarm/stack/manyfold
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- Service not available | Incorrect environment variables | Check and update `.env` file |
- Model library corrupted | Insufficient backups | Restore from backup or re-create model library |
- **Symptom:** Caddy fails to start.
- **Cause:** Incorrect configuration or environment variable issues.
- **Fix:** Review and correct the `.env` file, then restart Caddy.
- **Symptom:** Manyfold is not accessible.
- **Cause:** Incorrect reverse proxy URL or port issues.
- **Fix:** Review and correct the Caddy configuration, then restart Caddy.
---
@ -106,12 +107,16 @@ cd services/swarm/stack/manyfold
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-28 | 08489418 | Initial documentation creation |
| 2026-04-28 | 61224407 | Updated Docker Swarm configuration to use labels for routing and visibility |
| 2026-04-28 | cd055029 | Improved environment variable management and security |
| 2026-04-28 | c30dbfcb | Enhanced model library backup and restore functionality |
| 2026-04-28 | 4d037594 | Updated Uptime Kuma integration for monitoring purposes |
| 2026-04-28 | e91d90b6 | Fixed security vulnerability in Caddy reverse proxy configuration |
| 2026-04-28 | d8817d41 | Initial documentation for manyfold Stack |
| 2026-04-28 | 2e9903c4 | Migration to swarm configuration |
<Note: This documentation was generated by Gremlin on 2026-04-29T02:41:08.161Z>
<Source: swarm/manyfold.yaml>
<Write a paragraph summarizing the evolution of this service based on the diffs above.>
The manyfold Stack has been migrated from a traditional Docker Compose setup to a Docker Swarm configuration, providing more flexibility and scalability for NetGrimoire.
---
## Notes
- Generated by Gremlin on 2026-04-29T02:46:18.939Z
- Source: swarm/manyfold.yaml
- Review User Guide and Changelog sections