# manyfold

## Overview
The manyfold Stack is a Docker Swarm configuration that hosts the Manyfold service, a 3D library for NetGrimoire. It exposes the service on port 3214 via the netgrimoire overlay network.

---

## Architecture

| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** manyfold.netgrimoire.com, Internal only
- **Homepage group:** PNCHarris Apps

---

## Build & Configuration

### Prerequisites
No specific prerequisites for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/manyfold/config
chown -R user:group /DockerVol/manyfold/config
```

### Environment Variables
```bash
MIN_PASSWORD_SCORE: 1
SECRET_KEY_BASE: $(openssl rand -hex 32)
PUID: "1964"
PGID: "1964"
```

### 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
Upon first deployment, ensure all environment variables are correctly set.

---

## User Guide

### Accessing manyfold
| Service | URL |
|---------|-----|
manyfold.netgrimoire.com |

### Primary Use Cases
Use the Manyfold service as a 3D library for NetGrimoire applications.

### NetGrimoire Integrations
Connects to Uptime Kuma for monitoring and Authentik for authentication.

---

## Operations

### Monitoring
```bash
docker stack services manyfold
docker service logs manyfold
```

### Backups
Critical data is stored in /DockerVol/manyfold/models. Non-critical data can be backed up at any time.

### Restore
To restore the Manyfold service, run ./deploy.sh.

---

## Common Failures

* If the service does not start, check the logs and ensure that environment variables are set correctly.
* If the reverse proxy is down, restart the Caddy service on znas.
* If the Uptime Kuma monitoring service is down, restart the kuma.* services.

---

## Changelog
The Manyfold service has undergone significant changes in this release, including the migration to a Docker Swarm configuration. New features include improved security and scalability.

---

## Notes
- Generated by Gremlin on 2026-04-29T04:00:28.742Z
- Source: swarm/manyfold.yaml
- Review User Guide and Changelog sections