sebarocks/docker-windows
1
0
Fork 0
mirror of https://github.com/dockur/windows.git synced 2026-02-04 07:59:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
docker-windows/CHANGELOG.md
Michel Abboud 31b7153275 docs: Update changelog with all v1.0.0 features 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 17:12:14 +00:00

3.3 KiB
Raw Blame History

Changelog

All notable changes to this project will be documented in this file.

[1.0.0] - 2026-01-30

Added

  • winctl.sh: Management script for Windows Docker containers
    • 20+ commands: start, stop, restart, status, logs, shell, stats, build, rebuild, list, inspect, monitor, check, refresh, open, pull, disk, snapshot, restore, clean, destroy, instances, cache, help
    • Interactive menus for version selection
    • Prerequisites checking (Docker, Compose, KVM, TUN, memory, disk)
    • Color-coded output with professional table formatting
    • Safety confirmations for destructive operations
    • Support for all 22 Windows versions across 4 categories
    • JSON status cache (~/.cache/winctl/status.json) with auto-refresh
  • Multi-instance support: run multiple instances of the same version
    • start <version> --new creates auto-numbered instances with allocated ports
    • start <version> --new <name> creates named instances
    • --clone copies data from the base version
    • JSON registry (instances/registry.json) tracks all instances
    • instances lists all registered instances; destroy removes them
  • ISO cache: skip re-downloading ISOs for new instances
    • cache download <version> downloads original ISOs using the container's download logic
    • cache save <version> caches from data directory (skips rebuilt ISOs)
    • Auto-restore on start --new copies cached ISOs before container starts
    • cache list / cache rm / cache flush for cache management
    • Rebuilt ISOs (genisoimage output) detected and skipped automatically
  • Auto-cache on stop: AUTO_CACHE=Y in .env caches unprocessed ISOs when stopping
  • Snapshot & restore: back up and restore VM data directories
  • Topic-based help system: help [commands|instances|cache|examples|config|all]
    • Interactive numbered menu in terminal mode
    • Auto-disabled in pipes, CI, and batch environments
    • Aligned columns using _help_row() with ANSI-safe formatting
  • ARM64 auto-detection: blocks unsupported versions, shows [x86 only] tags
  • LAN IP detection with remote access URLs shown on start
  • Port conflict detection before starting containers
  • Disk usage monitoring with per-VM and snapshot breakdowns
  • Multi-version compose structure with organized folders (compose/)
  • Environment file configuration (.env / .env.example)
  • Two resource profiles: modern (8G RAM, 4 CPU) and legacy (2G RAM, 2 CPU)
  • Per-version data folders under data/
  • Pre-configured compose files for all Windows versions:
    • Desktop: Win 11, 10, 8.1, 7 (with Enterprise variants)
    • Legacy: Vista, XP, 2000
    • Server: 2003, 2008, 2012, 2016, 2019, 2022, 2025
    • Tiny: Tiny11, Tiny10
  • Unique port mappings for each version (no conflicts)
  • CLAUDE.md for Claude Code guidance
  • WINCTL_GUIDE.md comprehensive user guide

Changed

  • Default storage location changed from ./windows to ./data/
  • Compose files now use env_file for centralized configuration
  • Restart policy changed from always to on-failure
  • clean --data now unregisters instances and removes compose files

Resource Profiles

Profile RAM CPU Disk Used By
Modern 8G 4 128G Win 10/11, Server 2016+
Legacy 2G 2 32G Win 7/8, Vista, XP, 2000, Server 2003-2012, Tiny