Kopia

Key Features

• Content-addressable storage with advanced deduplication reducing storage requirements by up to 90%
• Parallel processing architecture delivering significantly faster backup speeds than Borg or Restic
• Multiple storage backend support including S3, Azure Blob, Google Cloud Storage, Backblaze B2, SFTP, WebDAV, and Rclone
• End-to-end AES-256 encryption with per-snapshot key derivation and optional compression
• Built-in retention policies with flexible scheduling for automatic snapshot cleanup
• Web-based management interface for monitoring backup status and browsing snapshot contents
• Cross-platform snapshot mounting for direct file system access to backup data
• Incremental forever backup strategy with block-level change detection

Common Use Cases

• 1Enterprise server backup with automated retention policies and cloud storage integration
• 2Development team project backup with version control-like snapshot browsing capabilities
• 3Media server content protection with efficient handling of large file repositories
• 4Database backup automation with point-in-time recovery capabilities
• 5Multi-site backup coordination through centralized web interface management
• 6Ransomware protection with encrypted off-site snapshot storage
• 7Home lab data protection with cost-effective cloud storage utilization

Prerequisites

• Docker and Docker Compose installed with at least 2GB available RAM for large backup operations
• Network access to port 51515 for web interface and API communication
• Sufficient storage space in Docker volumes for repository data and cache (recommend 10% of source data size for cache)
• Valid credentials and network access if using cloud storage backends (S3, Azure, GCS, B2)
• Understanding of backup retention requirements and storage backend configuration
• KOPIA_PASSWORD environment variable configured with strong password for web interface access

docker-compose.yml

1services: 
2  kopia: 
3    image: kopia/kopia:latest
4    container_name: kopia
5    restart: unless-stopped
6    command: server start --address=0.0.0.0:51515 --server-username=admin --server-password=${KOPIA_PASSWORD}
7    environment: 
8      KOPIA_PASSWORD: ${KOPIA_PASSWORD}
9    volumes: 
10      - kopia_config:/app/config
11      - kopia_cache:/app/cache
12      - kopia_repository:/repository
13      - /path/to/data:/data:ro
14    ports: 
15      - "51515:51515"
16
17volumes: 
18  kopia_config: 
19  kopia_cache: 
20  kopia_repository: 

.env Template

1KOPIA_PASSWORD=changeme

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  kopia:
5    image: kopia/kopia:latest
6    container_name: kopia
7    restart: unless-stopped
8    command: server start --address=0.0.0.0:51515 --server-username=admin --server-password=${KOPIA_PASSWORD}
9    environment:
10      KOPIA_PASSWORD: ${KOPIA_PASSWORD}
11    volumes:
12      - kopia_config:/app/config
13      - kopia_cache:/app/cache
14      - kopia_repository:/repository
15      - /path/to/data:/data:ro
16    ports:
17      - "51515:51515"
18
19volumes:
20  kopia_config:
21  kopia_cache:
22  kopia_repository:
23EOF
24
25# 2. Create the .env file
26cat > .env << 'EOF'
27KOPIA_PASSWORD=changeme
28EOF
29
30# 3. Start the services
31docker compose up -d
32
33# 4. View logs
34docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/kopia/run | bash

Troubleshooting