---
title: wiki Stack
description: Wiki services in NetGrimoire
published: true
date: 2026-05-03T03:10:35.229Z
tags: docker,swarm,wiki,netgrimoire
editor: markdown
dateCreated: 2026-05-03T03:10:35.229Z

---

# wiki

## Overview
The wiki stack in NetGrimoire provides a documentation server for the community. It consists of three services: wikijs, drawio, and wikijs-db.

---

## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|-----|
| wikijs  | requarks/wiki:2 | 3000 | Documentation Server |
| drawio   | jgraph/drawio:latest | 8080 | Draw Server |
| wikijs-db| postgres:16-alpine | 5432 | Database |

- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** wiki.netgrimoire.com, wiki.js.netgrimoire.com, draw.netgrimoire.com
- **Homepage group:** Documentation

---

## Build & Configuration

### Prerequisites
To build and deploy the wiki stack, you need to have Docker Swarm installed and configured on your node. Make sure that the `docker4` node is available in the swarm.

### Volume Setup
```bash
mkdir -p /DockerVol/wikijs-data
mkdir -p /DockerVol/wikijs-repo
mkdir -p /DockerVol/wikijs-ssh
```

### Environment Variables
```bash
# generate: openssl rand -hex 32
POSTGRES_PASSWORD=F@lcon13
DB_PASS=F@lcon13
DB_USER=wikijs
PUID=1964
PGID=1964
```

### Deploy
```bash
cd services/swarm/stack/wiki
set -a && source .env && set +a
docker stack config --compose-file wiki-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml wiki
rm resolved.yml
docker stack services wiki
```

### First Run
After deploying the wiki stack, run `./deploy.sh` to complete the initial setup.

---

## User Guide

### Accessing wiki
| Service | URL | Purpose |
|---------|-----|---------|
| wikijs  | http://wiki.netgrimoire.com | Documentation Server |
| drawio   | http://draw.netgrimoire.com | Draw Server |

### Primary Use Cases
The primary use case for this stack is to provide a documentation server for the community.

### NetGrimoire Integrations
This service integrates with other services in NetGrimoire, such as crowdsec and authentik.

---

## Operations

### Monitoring
```bash
docker stack services wiki
kuma.list --labels=kuma.*
```

### Backups
Critical data is stored on `/DockerVol/wikijs-data`. This volume should be backed up regularly to ensure the integrity of the database.

### Restore
If the wiki stack needs to be restored, run `./deploy.sh` to recreate the services and volumes.

---

## Common Failures
| Symptom | Cause | Fix |
|---------|------|-----|
| Database errors | Insufficient disk space | Increase disk space on `/DockerVol/wikijs-data` volume |
| Documentation server unavailable | Incorrect Caddy configuration | Check Caddy logs for errors |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-05-02 | 7a7a43bd | Initial documentation creation |
| 2026-05-02 | b5e13522 | Updated service labels and Caddy configuration |
| 2026-05-02 | 394193bf | Improved volume setup for secure data storage |
| 2026-05-02 | 5e2763c1 | Enhanced monitoring for wiki services |
| 2026-05-02 | 5630285d | Fixed documentation server URL |
| 2026-05-02 | f74f9fa0 | Updated deployment script for improved reliability |

Generated by Gremlin on 2026-05-03T03:10:35.229Z
Source: swarm/wiki.yaml
Review User Guide and Changelog sections