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

2.3 KiB
Raw Blame History

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

mkdir -p /DockerVol/manyfold/config
chown -R user:group /DockerVol/manyfold/config

Environment Variables

MIN_PASSWORD_SCORE: 1
SECRET_KEY_BASE: $(openssl rand -hex 32)
PUID: "1964"
PGID: "1964"

Deploy

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

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