Skip to main content

Deploy Docker Desktop on Windows with WSL2

Before you can install and run Keycloak in Docker Desktop on a Windows system (or systems), you need to verify your system meets the following prerequisites and perform the following pre-deployment steps.

Docker-Specific Software Requirements for Keycloak on Windows​

note

See the Prerequisites page for information about the required hardware and memory for Keycloak.

SoftwareVersion
Microsoft Windows (64-bit)
  • Server 2022 (Build 20348.740 and higher) / 2023
  • 10 (version 2004 and higher, Build 19043 and higher) / 11
    • Docker DesktopDesktop with WSL 2 enabled, up-to-date. See Install Docker Desktop on Windows for more information.
    Docker ComposeCompose 2.23.0 or higher (included in the Docker Desktop bundle)

    Installation and Pre-Deployment Checklist​

    Installing Docker Desktop​

    Install Docker Desktop on the Windows system where you plan to run the Docker container that will host Eggplant IAM.

    1. Download the required software. Refer to the Software Requirements table above for the list of what you need.

    2. Install Docker Desktop with the default settings that have Use WSL 2 instead of Hyper-V (recommended) enabled as shown in the sample Docker Desktop installation screen below. For more information, see Install Docker Desktop on Windows in the Docker documentation.

    3. Proceed through the installation. The Docker installation progress displays in the installer.

    Verifying the Docker Desktop Installation​

    1. Open a shell on your Windows system, if you do not already have one open.

    2. Verify that the Docker Compose version is 2.23.0 or higher by running the following command in your shell. If the output from the following command shows an older version, delete the cache folder at C:\Users\<username>\.docker and restart Docker Desktop.

      docker compose version

    3. In the Docker Desktop app, verify that WSL 2 is enabled in the Settings, under Resources > Advanced as shown in the following sample Docker Desktop screen.

    Next Step: Deploying Eggplant IAM with Docker​

    After you install and verify your Docker Desktop installation, and complete the pre-deployment checklist, continue to Deploying Eggplant IAM with Docker to install and deploy Eggplant IAM.

    Last updated on