{"id":28364261,"url":"https://github.com/ercindedeoglu/packmate","last_synced_at":"2026-04-26T20:32:03.616Z","repository":{"id":278696909,"uuid":"935910700","full_name":"ErcinDedeoglu/packmate","owner":"ErcinDedeoglu","description":"🗄️ High-performance Docker volume backup tool with configurable compression and JSON/text output","archived":false,"fork":false,"pushed_at":"2025-07-16T00:30:37.000Z","size":4985,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"v1.0","last_synced_at":"2025-07-17T01:02:51.002Z","etag":null,"topics":["archiver","backup","backup-tool","compression","container","devops","docker","docker-volume","golang","zip"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/dublok/packmate","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ErcinDedeoglu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-20T08:11:57.000Z","updated_at":"2025-07-16T00:30:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9af37c5-ed09-4e7e-9e7c-e93f0bd3cad4","html_url":"https://github.com/ErcinDedeoglu/packmate","commit_stats":null,"previous_names":["ercindedeoglu/packmate"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/ErcinDedeoglu/packmate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErcinDedeoglu%2Fpackmate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErcinDedeoglu%2Fpackmate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErcinDedeoglu%2Fpackmate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErcinDedeoglu%2Fpackmate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ErcinDedeoglu","download_url":"https://codeload.github.com/ErcinDedeoglu/packmate/tar.gz/refs/heads/v1.0","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErcinDedeoglu%2Fpackmate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32312248,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T19:15:34.056Z","status":"ssl_error","status_checked_at":"2026-04-26T19:15:15.467Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archiver","backup","backup-tool","compression","container","devops","docker","docker-volume","golang","zip"],"created_at":"2025-05-28T20:43:52.377Z","updated_at":"2026-04-26T20:32:03.611Z","avatar_url":"https://github.com/ErcinDedeoglu.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🗄️ PackMate\nA high-performance, Docker-ready archiving tool for backing up Docker volumes and directories\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/dublok/packmate.svg)](https://hub.docker.com/r/dublok/packmate)\n[![Docker Image Size](https://img.shields.io/docker/image-size/dublok/packmate/latest)](https://hub.docker.com/r/dublok/packmate)\n\u003c/div\u003e\n\n## 🚀 Features\n- **Performance**:  \n  - Fast \u0026 Efficient: Optimized for handling large datasets with minimal resource usage  \n  - Safe Operations: Read-only source handling and comprehensive error reporting  \n\n- **Flexibility**:  \n  - Configurable Compression: Choose between no compression for speed or maximum compression for space savings  \n  - Advanced Parameters: Support for custom compression methods, multi-volume archives, encryption, and more  \n\n- **Output Options**:  \n  - Multiple Output Formats: Support for both JSON and human-readable outputs  \n  - Custom Naming: Flexible archive naming options  \n\n- **Docker Integration**:  \n  - Purpose-built for Docker volume backups  \n  - Minimal container footprint with Alpine-based secure base image  \n\n## 📋 Usage\nPackMate provides a simple CLI interface for creating archives. Below are examples and parameter details to help you get started.\n\n### ⚡ Quick Start\n```bash\ndocker run --rm \\\n  -v /your/source/path:/source:ro \\\n  -v /your/backup/path:/output \\\n  dublok/packmate:latest \\\n  --name \"backup-$(date +%Y%m%d)\"\n```\n\n### 🎯 Parameters\n| Parameter           | Description                                                                 | Required | Default       |\n|---------------------|-----------------------------------------------------------------------------|----------|---------------|\n| `--source`          | Source directory to archive                                                | Yes      | `/source`     |\n| `--output`          | Output directory for the archive                                           | Yes      | `/output`     |\n| `--name`            | Custom name for the archive file                                           | No       | Base64 encoded path |\n| `--compression`     | Compression level (0: none, 1: fastest, 9: best compression)                | No       | `5`           |\n| `--method`          | Compression method (`copy`, `lzma2`, `ppmd`, etc.)                         | No       | `lzma2`       |\n| `--password`        | Password for encrypting the archive                                        | No       | None          |\n| `--header-encryption` | Enable header encryption                                                  | No       | `false`       |\n| `--volume-size`     | Create multi-volume archive with specified size (e.g., `100m`)             | No       | None          |\n| `--multithreading`  | Enable multithreading for faster compression                               | No       | `true`        |\n| `--extra`           | Additional `p7zip` flags (e.g., `-ms=off`)                                 | No       | None          |\n| `--format`          | Output format (`json` or `text`)                                           | No       | `json`        |\n\n### 📊 Compression Levels\n| Level | Description         | Use Case                                   |\n|-------|---------------------|--------------------------------------------|\n| `0`   | No compression      | Fastest, best for already compressed data |\n| `1`   | Best speed          | Good balance for compressible data        |\n| `5`   | Default compression | Balanced speed and compression ratio      |\n| `9`   | Best compression    | Smallest file size, slower compression    |\n\n### 🔐 Encryption Options\n| Parameter           | Description                                                                 |\n|---------------------|-----------------------------------------------------------------------------|\n| `--password`        | Encrypt the archive with a password                                         |\n| `--header-encryption` | Encrypt the archive headers for additional security                        |\n\n### 📦 Multi-Volume Archives\nUse the `--volume-size` parameter to split the archive into multiple files:\n```bash\n--volume-size=100m  # Creates 100 MB volumes\n```\n\n## 💡 Examples\n\n### Basic Backup (No Compression)\n```bash\ndocker run --rm \\\n  -v /var/lib/docker/volumes/myapp_data/_data:/source:ro \\\n  -v /backup:/output \\\n  dublok/packmate:latest \\\n  --name \"backup-$(date +%Y%m%d)\" \\\n  --compression=0 \\\n  --method=copy\n```\n\n### Maximum Compression Backup\n```bash\ndocker run --rm \\\n  -v /var/lib/docker/volumes/myapp_data/_data:/source:ro \\\n  -v /backup:/output \\\n  dublok/packmate:latest \\\n  --name \"backup-$(date +%Y%m%d)\" \\\n  --compression=9 \\\n  --method=lzma2\n```\n\n### Encrypted Backup\n```bash\ndocker run --rm \\\n  -v /var/lib/docker/volumes/myapp_data/_data:/source:ro \\\n  -v /backup:/output \\\n  dublok/packmate:latest \\\n  --name \"backup-$(date +%Y%m%d)\" \\\n  --compression=5 \\\n  --method=lzma2 \\\n  --password=secret \\\n  --header-encryption\n```\n\n### Multi-Volume Archive\n```bash\ndocker run --rm \\\n  -v /var/lib/docker/volumes/myapp_data/_data:/source:ro \\\n  -v /backup:/output \\\n  dublok/packmate:latest \\\n  --name \"backup-$(date +%Y%m%d)\" \\\n  --compression=5 \\\n  --method=lzma2 \\\n  --volume-size=100m\n```\n\n### Fastest Archiving (No Compression, No Solid Mode)\n```bash\ndocker run --rm \\\n  -v /var/lib/docker/volumes/myapp_data/_data:/source:ro \\\n  -v /backup:/output \\\n  dublok/packmate:latest \\\n  --name \"backup-$(date +%Y%m%d)\" \\\n  --compression=0 \\\n  --method=copy \\\n  --multithreading=true \\\n  --extra=\"-ms=off\"\n```\n\n## 📤 Output Examples\n\n### JSON Format\n```json\n{\n  \"path\": \"/source\",\n  \"archivePath\": \"/output/backup-20250221.7z\",\n  \"status\": \"Success\",\n  \"compressionLevel\": 0,\n  \"error\": \"\"\n}\n```\n\n### Text Format\n```\nArchive Creation Result:\n=======================\n✅ Path: /source\n   Archive: /output/backup-20250221.7z\n   Compression Level: 0\n   Status: Success\n```\n\n## 🔒 Security Features\n- Source volumes mounted read-only (`ro`)  \n- No root privileges required  \n- Minimal container footprint  \n- Alpine-based secure base image  \n\n## 🏗️ Building from Source\n```bash\n# Build the Docker image\ndocker build -t packmate:latest -f src/Dockerfile src\n\n# Optional: Tag and push to your registry\ndocker tag packmate:latest your-registry/packmate:latest\ndocker push your-registry/packmate:latest\n```\n\n## ⚙️ Technical Specifications\n- Go 1.23+  \n- Alpine Linux base  \n- Uses `p7zip` for `.7z` archive creation  \n- No external runtime dependencies  \n- Efficient buffering for large files  \n- Minimal memory footprint  \n- Multi-stage Docker builds  \n\n## 📫 Contact \u0026 Support\n\u003cdiv align=\"center\"\u003e\n\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue.svg)](https://www.linkedin.com/in/ercindedeoglu/) \n[![GitHub](https://img.shields.io/github/followers/ErcinDedeoglu?label=Follow\u0026style=social)](https://github.com/ErcinDedeoglu)  \nIf you find this project useful, please consider giving it a ⭐\n\u003c/div\u003e\n\n---\n\u003cdiv align=\"center\"\u003e\n\nMade with ❤️ by [Ercin Dedeoglu](https://github.com/ErcinDedeoglu)\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fercindedeoglu%2Fpackmate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fercindedeoglu%2Fpackmate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fercindedeoglu%2Fpackmate/lists"}