Windows Server 2022 — Docker installation fails because Containers feature is not enabled — Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution — Primary Fix
7. Solution — Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Docker engine setup aborts and container workloads cannot be deployed.

Environment & Reproduction

Happens when Containers and Hyper-V prerequisites are absent.

Install-Package -Name docker -ProviderName DockerMsftProvider

Root Cause Analysis

Docker runtime cannot initialize isolation drivers without required Windows features.

Quick Triage

Check feature prerequisites and package sources.

Get-WindowsFeature Containers,Hyper-V
Get-PackageProvider

Step-by-Step Diagnosis

Inspect installation logs and service registration failures.

Get-EventLog -LogName Application -Newest 50

Solution — Primary Fix

Enable prerequisites, reboot, then reinstall Docker packages.

Install-WindowsFeature -Name Containers,Hyper-V -IncludeManagementTools -Restart
Install-Module DockerMsftProvider -Force
Install-Package -Name docker -ProviderName DockerMsftProvider -Force

Solution — Alternative Approaches

Use Mirantis Container Runtime where enterprise support is required.

# Install Mirantis runtime per vendor docs

Verification & Acceptance Criteria

Docker service starts and test container runs.

Start-Service docker
docker version
docker run mcr.microsoft.com/windows/nanoserver:ltsc2022 cmd /c ver

Rollback Plan

Uninstall runtime and remove features if host profile changes.

Uninstall-Package -Name docker -Force

Prevention & Hardening

Bake feature prerequisites into gold images and patch cadence.

Get-WindowsFeature Containers,Hyper-V

Related Errors & Cross-Refs

Related: HCS startup errors and image pull platform mismatch.

Related tutorial: View the step-by-step tutorial for Windows Server 2022.

View all Windows Server 2022 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Windows containers installation docs and Docker runtime guidance for Server 2022.