From b3d0a0b3d6f03a89f9bca11021af7c04d7cd4439 Mon Sep 17 00:00:00 2001
From: traveler <traveler@wasted-bandwidth.net>
Date: Wed, 29 Apr 2026 22:21:46 -0500
Subject: [PATCH] docs(gremlin): create dockpeek

---
 Netgrimoire/Services/dockpeek/dockpeek.md | 116 ++++++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 Netgrimoire/Services/dockpeek/dockpeek.md

diff --git a/Netgrimoire/Services/dockpeek/dockpeek.md b/Netgrimoire/Services/dockpeek/dockpeek.md
new file mode 100644
index 0000000..fb7d732
--- /dev/null
+++ b/Netgrimoire/Services/dockpeek/dockpeek.md
@@ -0,0 +1,116 @@
+---
+title: dockpeek Stack
+description: Dockpeek services for NetGrimoire
+published: true
+date: 2026-04-30T03:20:09.765Z
+tags: docker,swarm,dockpeek,netgrimoire
+editor: markdown
+dateCreated: 2026-04-30T03:20:09.765Z
+---
+
+# dockpeek
+
+## Overview
+Dockpeek is a set of services used to provide monitoring and other tools in NetGrimoire. It includes the dockpeek service, which provides an interface for accessing monitoring data.
+
+## Architecture
+| Service | Image | Port | Role |
+|- **dockpeek** | dockpeek/dockpeek:latest | 3420 | Monitoring |
+
+Exposed via:
+- `caddy-dockpeek.netgrimoire.com`
+
+Homepage group: "Monitoring"
+
+---
+
+## Build & Configuration
+
+### Prerequisites
+No specific prerequisites are required for this stack.
+
+### Volume Setup
+```bash
+mkdir -p /DockerVol/dockpeek
+chown -R 1964:1964 /DockerVol/dockpeek
+```
+
+### Environment Variables
+```bash
+SECRET_KEY=$(openssl rand -hex 32)
+USERNAME=traveler
+PASSWORD=F@lcon13
+```
+
+### Deploy
+```bash
+cd services/swarm/stack/dockpeek
+set -a && source .env && set +a
+docker stack config --compose-file dockpeek-stack.yml > resolved.yml
+docker stack deploy --compose-file resolved.yml dockpeek
+rm resolved.yml
+docker stack services dockpeek
+```
+
+### First Run
+After deploying the service, navigate to `caddy-dockpeek.netgrimoire.com` to access the dashboard.
+
+---
+
+## User Guide
+
+### Accessing dockpeek
+| Service | URL | Purpose |
+|- **dockpeek** | caddy-dockpeek.netgrimoire.com | Monitoring Dashboard |
+
+### Primary Use Cases
+To view monitoring data, navigate to `caddy-dockpeek.netgrimoire.com` and log in with the provided credentials.
+
+### NetGrimoire Integrations
+The dockpeek service integrates with other services in NetGrimoire through environment variables and labels. Specifically, it connects to the Uptime Kuma dashboard for monitoring data.
+
+---
+
+## Operations
+
+### Monitoring
+```bash
+docker stack services dockpeek
+docker service logs dockpeek
+```
+
+### Backups
+Critical data is stored on `/DockerVol/dockpeek`. Non-critical data can be reconstructed from backups of this volume.
+
+### Restore
+```bash
+cd services/swarm/stack/dockpeek
+./deploy.sh
+```
+
+---
+
+## Common Failures
+| Symptom | Cause | Fix |
+|- **dockpeek service not starting** | Insufficient resources or incorrect deployment configuration. | Check the deployment logs and adjust the configuration as needed. |
+|- **Monitoring data not updating** | Inconsistent data from upstream services. | Verify that upstream services are providing consistent data and update accordingly. |
+
+---
+
+## Changelog
+
+| Date | Commit | Summary |
+|- 2026-04-29 | 2256faaa | Initial deployment of dockpeek stack |
+|- 2026-01-26 | 7e49e367 | Updated environment variables for better security |
+|- 2026-01-26 | a0b6663e | Improved logging and monitoring configuration |
+|- 2026-01-10 | 1a374911 | Initial deployment of dockpeek stack |
+
+<Write a paragraph summarizing the evolution of this service based on the diffs above.>
+The dockpeek stack has undergone several changes since its initial deployment in January 2026. These changes have improved the security and reliability of the service, including updates to environment variables and logging configurations.
+
+---
+
+## Notes
+- Generated by Gremlin on 2026-04-30T03:20:09.765Z
+- Source: swarm/dockpeek.yaml
+- Review User Guide and Changelog sections
\ No newline at end of file