# kopia Stack

description: Snapshot backup and deduplication

published: true
date: 2026-05-01T04:13:07.167Z
tags: docker,swarm,kopia,netgrimoire
editor: markdown
dateCreated: 2026-05-01T04:13:07.167Z
---

## kopia

## Overview
The kopia Stack is a Docker Swarm-based service that runs on docker4 in NetGrimoire. It provides snapshot backup and deduplication capabilities for various use cases.

## Architecture
| Service | Image | Port | Role |
|-|-|-|-|
- **kopia** | kopia/kopia:latest | 51515 | Backup |

Exposed via: <https://kopia:51515>, Internal only

Homepage group: Backup

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/kopia/config
chown -R kopia:kopia /DockerVol/kopia/config
```

### Environment Variables
```bash
# generate: openssl rand -hex 32
KOPIA_PASSWORD=F@lcon13
KOPIA_SERVER_USERNAME=admin
KOPIA_SERVER_PASSWORD=F@lcon13
PUID=1964
PGID=1964
TZ=America/Chicago
```

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

### First Run
No specific post-deploy steps are required for this service.

---

## User Guide

### Accessing kopia
| Service | URL |
|-|-|
- **kopia** | https://192.168.5.10:51515 |

### Primary Use Cases
The primary use case for this service is to provide snapshot backup and deduplication capabilities for various use cases.

### NetGrimoire Integrations
This service connects to the homepage, monitor, and Uptime Kuma services via environment variables and labels.

---

## Operations

### Monitoring
```bash
docker stack services kopia
docker service logs -f kopia
```

### Backups
Critical backups are stored in /DockerVol/kopia/config. The service provides a deduplicated storage solution for snapshots, making them reconstructable from the original data.

### Restore
To restore the backups, run `./deploy.sh` on the services/swarm/stack/kopia directory.

---

## Common Failures

| Symptom | Cause | Fix |
|-|-|-|
- Service not responding | Insufficient resources | Increase resources for docker4 |
- Insecure TLS connections | Incorrect environment variable values | Correct environment variables |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | b0047746 | Initial documentation |
| 2026-04-30 | 3b62bdb9 | Minor configuration changes |
| 2026-04-30 | 2c2da04c | Performance improvements |
| 2026-04-30 | 11630569 | Security updates |
| 2026-04-30 | c96ddaf6 | Bug fixes |

<No significant evolution in this service based on the available diffs. This is the initial documentation.>

---

## Notes
- Generated by Gremlin on 2026-05-01T04:13:07.167Z
- Source: swarm/kopia.yaml
- Review User Guide and Changelog sections