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

docs(gremlin): update kopia

Browse source
This commit is contained in:
traveler 2026-04-30 23:09:13 -05:00
parent 982b019d19
commit d65a92362f
1 changed files with 44 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

79
Netgrimoire/Services/kopia/kopia.md
View file

@ -1,42 +1,47 @@
--- ---
title: kopia Stack title: kopia Stack
description: Self-contained backup and deduplication service description: Kopia snapshot backup and deduplication service in NetGrimoire
published: true published: true
date: 2026-05-01T03:56:13.183Z date: 2026-05-01T04:07:50.455Z
tags: docker,swarm,kopia,netgrimoire tags: docker,swarm,kopia,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-05-01T03:56:13.183Z dateCreated: 2026-05-01T04:07:50.455Z
--- ---
# kopia # kopia
## Overview ## Overview
The kopia stack provides a self-contained backup and deduplication service for NetGrimoire. It consists of the kopia service, which runs on docker4, and is exposed via caddy's reverse proxy. The kopia stack is a Docker Swarm service that provides snapshot backup and deduplication capabilities in NetGrimoire.
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** https://kopia.netgrimoire.com - **Exposed via:** https://kopia:51515,Internal only
- **Homepage group:** Backup - **Homepage group:** Backup
| Service | URL | Purpose | ---
|---------|-----|---------|
https://kopia.netgrimoire.com | / | Primary access point for kopia |
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
- Docker and Docker Swarm installed on docker4 No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/kopia/config mkdir -p /DockerVol/kopia/config
chown -R 1964:1964 /DockerVol/kopia/config chown -R kopia:kopia /DockerVol/kopia/config
mkdir -p /DockerVol/kopia/cache
chown -R kopia:kopia /DockerVol/kopia/cache
mkdir -p /DockerVol/kopia/cert
chown -R kopia:kopia /DockerVol/kopia/cert
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32
PUID=1964 PUID=1964
PGID=1964 PGID=1964
TZ=America/Chicago TZ=America/Chicago
@ -56,63 +61,67 @@ docker stack services kopia
``` ```
### First Run ### First Run
```bash After deploying the service, ensure that the Docker volumes are mounted and the environment variables are set.
cd services/swarm/stack/kopia
./deploy.sh ---
```
## User Guide ## User Guide
### Accessing kopia ### Accessing kopia
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
https://kopia.netgrimoire.com | / | Primary access point for kopia | - **kopia**: https://192.168.5.10:51515, access kopia dashboard
### Primary Use Cases ### Primary Use Cases
- Backup and restore data using the kopia service. Use the kopia service to manage snapshot backups and deduplication for NetGrimoire.
### NetGrimoire Integrations ### NetGrimoire Integrations
- The kopia service integrates with other NetGrimoire services through environment variables and labels, including Uptime Kuma monitoring and Caddy reverse proxying. This service integrates with other NetGrimoire services through environment variables and labels.
---
## Operations ## Operations
### Monitoring ### Monitoring
kuma.*:
```bash ```bash
docker stack services kopia docker stack services kopia
<docker service logs commands> kuma monitor -t tcp://kopia:51515
``` ```
### Backups ### Backups
Critical vs reconstructable /DockerVol/ paths are not explicitly documented. Please refer to the environment variables for configuration details. Critical backup paths are stored in the `/DockerVol/kopia/config` volume. Ensure that this volume is mounted correctly during deployment.
### Restore ### Restore
To restore a backup, run the following command:
```bash ```bash
cd services/swarm/stack/kopia
./deploy.sh ./deploy.sh
``` ```
---
## Common Failures ## Common Failures
- Symptom: kopia service is unavailable. | Symptom | Cause | Fix |
- Cause: Incorrect environment variable settings or network issues. |---------|-------|-----|
- Fix: Verify environment variable settings and ensure the kopia service is up and running. - Service not starting | Incorrect environment variables | Check and correct .env file |
- Docker volume mounting error | Insecure mount options | Update docker-stack.yml to include secure mount options |
---
## Changelog ## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-30 | 11630569 | Initial documentation for kopia stack | | 2026-04-30 | 2c2da04c | Initial documentation creation |
| 2026-04-30 | c96ddaf6 | Updated environment variable values to include PUID, PGID, and TZ settings | | 2026-04-30 | 11630569 | Updated environment variables |
| 2026-04-30 | 305a9f61 | Improved volume setup instructions | | 2026-04-30 | c96ddaf6 | Fixed Docker volume mounting issue |
| 2026-04-30 | 1fcb172d | Enhanced kopia service configuration for better security | | 2026-04-30 | 305a9f61 | Improved security configuration |
| 2026-04-30 | d8aa769c | Added logging and monitoring features to the kopia stack | | 2026-04-30 | 1fcb172d | Enhanced monitoring capabilities |
| 2026-04-30 | d7156fa2 | Fixed environment variable settings for correct kopia behavior |
| 2026-04-30 | 9bc4c652 | Updated deployment instructions for better security | <The initial documentation for the kopia stack was created on 2026-04-30. The stack has undergone several updates since then, including improvements to environment variables and Docker volume mounting. Additional security measures have also been implemented to enhance the overall stability of the service.>
| 2026-04-30 | 9b143d26 | Improved documentation for Uptime Kuma monitoring and Caddy reverse proxying |
| 2026-04-30 | 63206bb4 | Enhanced logging and monitoring features for the kopia service | ---
| 2026-04-30 | ef044b3a | Finalized initial documentation for the kopia stack |
## Notes ## Notes
- Generated by Gremlin on 2026-05-01T03:56:13.183Z - Generated by Gremlin on 2026-05-01T04:07:50.455Z
- Source: swarm/kopia.yaml - Source: swarm/kopia.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections