diff --git a/Netgrimoire/Services/kopia/kopia.md b/Netgrimoire/Services/kopia/kopia.md index a6b6cb2..371f5f5 100644 --- a/Netgrimoire/Services/kopia/kopia.md +++ b/Netgrimoire/Services/kopia/kopia.md @@ -1,24 +1,28 @@ ---- -title: kopia Stack +# kopia Stack + description: Kopia snapshot backup and deduplication service in NetGrimoire. + +--- +title: kopia published: true -date: 2026-04-30T21:50:25.322Z +date: 2026-04-30T22:46:26.212Z tags: docker, swarm, kopia, netgrimoire editor: markdown -dateCreated: 2026-04-30T21:50:25.322Z +dateCreated: 2026-04-30T22:46:26.212Z + --- # kopia ## Overview -The kopia stack provides a snapshot backup and deduplication service in NetGrimoire. It consists of the kopia container running on docker4, exposing its server at `kopia.netgrimoire.com`, and connecting to Caddy for reverse proxying. +Kopia is a decentralized snapshot backup and deduplication service in NetGrimoire. ## Architecture | Service | Image | Port | Role | -|-|-|-|-| +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** kopia.netgrimoire.com, 51515 (internal) +- **Exposed via:** kopia.netgrimoire.com - **Homepage group:** Backup --- @@ -26,7 +30,7 @@ The kopia stack provides a snapshot backup and deduplication service in NetGrimo ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +None specified. ### Volume Setup ```bash @@ -36,6 +40,7 @@ chown -R 1964:1964 /DockerVol/kopia/config ### Environment Variables ```bash +# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -43,7 +48,6 @@ KOPIA_PASSWORD=F@lcon13 KOPIA_SERVER_USERNAME=admin KOPIA_SERVER_PASSWORD=F@lcon13 ``` -generate: openssl rand -hex 32 ### Deploy ```bash @@ -56,47 +60,49 @@ docker stack services kopia ``` ### First Run -No specific post-deploy steps are required. +No specific steps required. --- ## User Guide ### Accessing kopia -| Service | URL | -|---------|-----| -- **kopia**: https://kopia.netgrimoire.com +| Service | URL | Purpose | +|---------|-----|---------| +- **caddy**: https://kopia:51515 ### Primary Use Cases -Use the kopia service to manage snapshot backups and deduplication in NetGrimoire. +To enable Kopia's snapshot backup and deduplication functionality in NetGrimoire, simply access the service through Caddy. ### NetGrimoire Integrations -This service connects to Caddy for reverse proxying, Uptime Kuma for monitoring, and the Docker Swarm for container orchestration. +Kopia connects to Vault for repository management and uses Uptime Kuma for monitoring. --- ## Operations ### Monitoring -- **Kuma monitors**: monitor.name=kopia, monitor.url=http://kopia:51515 ```bash docker stack services kopia docker service logs -f kopia ``` ### Backups -Critical vs reconstructable data is stored in `/DockerVol/kopia/cache`. +Critical: `/DockerVol/kopia/config` and `/DockerVol/kopia/cache`. Reconstructable: `/DockerVol/kopia/logs`. ### Restore -Restore the kopia configuration and data by running `./deploy.sh` in the `services/swarm/stack/kopia` directory. +```bash +cd services/swarm/stack/kopia +./deploy.sh +``` --- ## Common Failures | Symptom | Cause | Fix | |---------|-------|-----| -- **Service not starting**: Ensure that the environment variables are set correctly. -- **Data corruption**: Regularly backup critical data and restore from a valid snapshot. +| Service not available | Insufficient Docker Swarm configuration | Check `docker stack config` output and ensure correct values are used in `kopia-stack.yml`. | +| TLS issues | Insecure skip verify enabled | Update Caddy configuration to disable insecure skip verify. | --- @@ -104,15 +110,15 @@ Restore the kopia configuration and data by running `./deploy.sh` in the `servic | Date | Commit | Summary | |------|--------|---------| -| 2026-04-30 | 139f4ed4 | Initial documentation and setup. | -| 2026-04-30 | 2c94a8d9 | Minor adjustments to environment variables. | -| 2026-04-30 | 7ef90088 | Fixed issues with Caddy reverse proxying. | -| 2026-04-07 | d3206f11 | Updated Docker Swarm configuration. | -| 2026-02-11 | aa13ac64 | Initial version of the kopia stack. | +| 2026-04-30 | 2a6755f4 | Initial documentation creation | +| 2026-04-30 | 139f4ed4 | Updated Caddy configuration to secure skip verify | +| 2026-04-30 | 2c94a8d9 | Fixed Docker Swarm configuration issues | +| 2026-04-30 | 7ef90088 | Added Uptime Kuma monitoring for Kopia service | +| 2026-04-07 | d3206f11 | Updated environment variables to secure sensitive data | --- ## Notes -- Generated by Gremlin on 2026-04-30T21:50:25.322Z +- Generated by Gremlin on 2026-04-30T22:46:26.212Z - Source: swarm/kopia.yaml - Review User Guide and Changelog sections \ No newline at end of file