Skip to content

qnap-docker v0.1.0 - Initial Release

Choose a tag to compare

@scttfrdmn scttfrdmn released this 15 Sep 00:10
· 12 commits to main since this release

🎉 First stable release of qnap-docker CLI tool for QNAP Container Station!

🚀 Key Features

  • One-command deployment - Deploy containers as easily as qnap-docker run nginx
  • Dynamic Container Station detection - Automatically finds Docker binary across all volume types
  • Multi-volume support - CACHEDEV, ZFS, USB, external storage compatibility
  • SSH authentication - Both SSH keys and ssh-agent support
  • Docker Compose deployment - Multi-container applications
  • Container lifecycle management - run, ps, rm commands
  • Single binary - No dependencies required

🏗️ Architecture Highlights

  • Dynamic Docker Binary Detection: Works with any QNAP storage configuration
  • Multi-Volume Support: CACHEDEV*_DATA, ZFS*_DATA, USB, external volumes
  • Path Resolution: Smart QNAP volume path handling and expansion
  • Integration Tested: Verified on real QNAP hardware with Container Station

✅ Verified Compatibility

  • QNAP Container Station - Dynamic detection across storage pools
  • Docker 27.1.2-qnap4 - Tested and working
  • ZFS Storage Pools - ZFS530_DATA and other ZFS volumes
  • CACHEDEV Volumes - Traditional CACHEDEV1_DATA, CACHEDEV2_DATA, etc.
  • Multi-Platform - macOS (Intel/Apple Silicon), Linux (amd64/arm64)

📦 Installation

Homebrew (Recommended)

brew install scttfrdmn/tap/qnap-docker

Direct Download

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

🚀 Quick Start

# Setup connection (auto-detects your volumes and Container Station)
qnap-docker init your-nas.local

# Deploy your first container  
qnap-docker run nginx:latest --name web --port 8080:80

# Deploy multi-container application
qnap-docker deploy ./docker-compose.yml

# List and manage containers
qnap-docker ps
qnap-docker rm web

🔗 Related Projects

Sister project to syno-docker for Synology NAS systems.


Made with ❤️ for the QNAP community

Full Changelog: https://github.com/scttfrdmn/qnap-docker/commits/v0.1.0