Skip to main content

DistroNexus v2.2.0 Released — Deep Instance Management

· 2 min read

DistroNexus v2.2.0 is here. This release focuses on deep instance management: two major features and nine enhancements that expand the PowerShell module from 15 to 36 cmdlets, giving you full operational control over your WSL instances.

What's New in v2.2.0?​

VHDX Disk Compaction (F-01)​

Reclaim unused disk space with a single command:

Compress-DistroNexusInstance -Name "Ubuntu-24.04"

Use -WhatIf for a dry-run estimate before committing. The cmdlet runs fstrim inside the instance, then invokes Optimize-VHD (Hyper-V) or diskpart as a fallback.

Docker Desktop Integration (F-02)​

Manage Docker Desktop's WSL backend integration directly from PowerShell:

Get-DistroNexusDockerIntegration
Enable-DistroNexusDockerIntegration -Name "Ubuntu-24.04"
Disable-DistroNexusDockerIntegration -Name "Ubuntu-24.04"

Backup Scheduling (E-04)​

Schedule automated backups via Windows Task Scheduler:

New-DistroNexusBackupSchedule -Name "Ubuntu-24.04" -Frequency "Daily" -RetentionCount 7
Invoke-DistroNexusBackup -Name "Ubuntu-24.04"

Instance Tagging (E-06)​

Organise instances with tags:

Set-DistroNexusInstanceTag -Name "Ubuntu-24.04" -Tags "dev", "python"
Get-DistroNexusInstanceTag -Name "Ubuntu-24.04"

Port Forwarding Visualization (E-05)​

See what's listening inside your WSL instances at a glance:

Get-DistroNexusPortMapping -Name "Ubuntu-24.04"

And More​

  • Export / Import (E-01): back up and restore instances as .tar archives.
  • Global .wslconfig editor (E-02): read and write WSL global settings with safety guards.
  • Instance resource configuration (E-03): view and set sparse VHDX mode per instance.
  • Proactive cache invalidation (E-07): instance list stays fresh automatically after state changes.
  • Unified error codes (E-09): structured DistroNexusErrorCode enum across all exceptions.

Download​

Get v2.2.0 from the GitHub Releases page.

See the full v2.2.0 Release Notes for a complete change breakdown.