Skip to content

qnap-docker v0.2.0 - Complete Docker Management Suite

Choose a tag to compare

View all tags
@scttfrdmn scttfrdmn released this 15 Sep 01:18
· 7 commits to main since this release
v0.2.0
aafd969

🚀 Major feature release bringing comprehensive Docker management to QNAP NAS!

🆕 What's New in v0.2.0

🛠️ Complete Docker Management Suite

  • 15 New Commands + 18 Subcommands = 41 total commands
  • Full feature parity with syno-docker v0.2.0
  • Complete Docker workflow from deployment to maintenance

📦 New Command Categories

Container Operations

  • qnap-docker logs - View container logs (follow, tail, timestamps)
  • qnap-docker exec - Execute commands inside containers (interactive mode)
  • qnap-docker start/stop/restart - Complete container lifecycle control
  • qnap-docker stats - Real-time resource usage monitoring

Image Management

  • qnap-docker images - List images with filtering and digest support
  • qnap-docker pull - Pull images with platform-specific options
  • qnap-docker rmi - Remove images with force options
  • qnap-docker import/export - Container backup and restore

Volume Management

  • qnap-docker volume ls/create/rm/inspect/prune - Complete volume lifecycle
  • Custom driver support and metadata labels
  • Unused volume cleanup and disk space management

Network Management

  • qnap-docker network ls/create/rm/inspect - Network lifecycle
  • qnap-docker network connect/disconnect - Container network management
  • Advanced networking with CIDR, gateways, IPv6 support

System Operations

  • qnap-docker system df - Docker disk usage monitoring
  • qnap-docker system info - Comprehensive system information
  • qnap-docker system prune - Cleanup unused containers, images, networks

Advanced Tools

  • qnap-docker inspect - Detailed object inspection (containers, images, volumes, networks)

⚡ Enhanced Capabilities

  • Real-time Monitoring: Live container stats and log streaming
  • Interactive Execution: Full TTY support for container commands (exec -it)
  • Advanced Networking: Custom bridge networks with CIDR configuration
  • Volume Persistence: Named volume management with custom drivers
  • System Maintenance: Comprehensive cleanup and resource monitoring
  • Professional Backup: Container export/import functionality

🏗️ Architecture Improvements

  • Dynamic Docker Detection - Works with any QNAP storage configuration
  • Multi-Volume Support - CACHEDEV, ZFS, USB, external storage compatibility
  • Stream Handling - Real-time commands (logs --follow, stats)
  • Interactive Mode - TTY allocation and interactive shells
  • Resource Monitoring - System and container performance metrics

✅ Verified Compatibility

  • QNAP Container Station - Dynamic detection across storage pools
  • Docker 27.1.2-qnap4 - Tested on real QNAP hardware
  • ZFS Storage Pools - Full support for ZFS*_DATA volumes
  • CACHEDEV Volumes - Traditional CACHEDEV*_DATA support
  • Multi-Platform - macOS (Intel/Apple Silicon), Linux (amd64/arm64)

📦 Installation

Homebrew (Recommended)

brew tap scttfrdmn/qnap-docker
brew install qnap-docker

Direct Download

Download the appropriate binary for your platform from the assets below.

🚀 Example Workflows

Complete Container Lifecycle

# Deploy with advanced options
qnap-docker run nginx:latest --name web --port 80:80 --restart unless-stopped

# Monitor and interact
qnap-docker logs web --follow --timestamps
qnap-docker exec -it web /bin/bash
qnap-docker stats web --no-stream

# Control state
qnap-docker stop web
qnap-docker start web
qnap-docker restart web

Advanced Networking

# Create custom network
qnap-docker network create app-net --driver bridge --subnet 172.20.0.0/16

# Connect containers
qnap-docker network connect app-net web --alias webapp
qnap-docker network ls --filter driver=bridge
qnap-docker network inspect app-net

Volume & Data Management

# Create and manage volumes
qnap-docker volume create data --driver local --label env=production
qnap-docker volume ls --quiet
qnap-docker volume inspect data

# System maintenance
qnap-docker system df --verbose
qnap-docker system prune --all --volumes --force

Container Backup & Restore

# Export container
qnap-docker export web-server --output web-backup.tar

# Import as new image
qnap-docker import web-backup.tar my-web-image:latest

🔗 Related Projects

Sister project to syno-docker for Synology NAS systems.

Made with ❤️ for the QNAP community

Assets 6
Loading