Skip to main content
Redhat Developers  Logo
  • AI

    Get started with AI

    • Red Hat AI
      Accelerate the development and deployment of enterprise AI solutions.
    • AI learning hub
      Explore learning materials and tools, organized by task.
    • AI interactive demos
      Click through scenarios with Red Hat AI, including training LLMs and more.
    • AI/ML learning paths
      Expand your OpenShift AI knowledge using these learning resources.
    • AI quickstarts
      Focused AI use cases designed for fast deployment on Red Hat AI platforms.
    • No-cost AI training
      Foundational Red Hat AI training.

    Featured resources

    • OpenShift AI learning
    • Open source AI for developers
    • AI product application development
    • Open source-powered AI/ML for hybrid cloud
    • AI and Node.js cheat sheet

    Red Hat AI Factory with NVIDIA

    • Red Hat AI Factory with NVIDIA is a co-engineered, enterprise-grade AI solution for building, deploying, and managing AI at scale across hybrid cloud environments.
    • Explore the solution
  • Learn

    Self-guided

    • Documentation
      Find answers, get step-by-step guidance, and learn how to use Red Hat products.
    • Learning paths
      Explore curated walkthroughs for common development tasks.
    • See all learning

    Hands-on

    • Developer Sandbox
      Spin up Red Hat's products and technologies without setup or configuration.
    • Interactive labs
      Learn by doing in these hands-on, browser-based experiences.
    • Interactive demos
      Click through product features in these guided tours.

    Browse by topic

    • AI/ML
    • Automation
    • Java
    • Kubernetes
    • Linux
    • See all topics

    Training & certifications

    • Courses and exams
    • Certifications
    • Skills assessments
    • Red Hat Academy
    • Learning subscription
    • Explore training
  • Build

    Get started

    • Red Hat build of Podman Desktop
      A downloadable, local development hub to experiment with our products and builds.
    • Developer Sandbox
      Spin up Red Hat's products and technologies without setup or configuration.

    Download products

    • Access product downloads to start building and testing right away.
    • Red Hat Enterprise Linux
    • Red Hat AI
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products

    Featured

    • Red Hat build of OpenJDK
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenShift Dev Spaces
    • Red Hat Developer Toolset

    References

    • E-books
    • Documentation
    • Cheat sheets
    • Architecture center
  • Community

    Get involved

    • Events
    • Live AI events
    • Red Hat Summit
    • Red Hat Accelerators
    • Community discussions

    Follow along

    • Articles & blogs
    • Developer newsletter
    • Videos
    • Github

    Get help

    • Customer service
    • Customer support
    • Regional contacts
    • Find a partner

    Join the Red Hat Developer program

    • Download Red Hat products and project builds, access support documentation, learning content, and more.
    • Explore the benefits

How to use RHEL as a WSL Podman machine

September 30, 2024
Jeff Maury
Related topics:
ContainersDeveloper toolsApplication modernizationVirtualizationWindows
Related products:
Developer ToolsetImage mode for Red Hat Enterprise LinuxPodman Desktop

    This article from last year details the steps and actions required to build and run your Red Hat Enterprise Linux (RHEL) Windows Subsystem for Linux (WSL) image.

    The purpose of this article is to describe the options needed for the RHEL WSL distribution so that it can be used as a Podman machine.

    Requirements

    To use the RHEL WSL image as a Podman machine, ensure that the following packages are installed:

    • podman
    • podman-docker
    • procps-ng
    • openssh-server
    • net-tools
    • iproute
    • dhcp-client
    • sudo
    • systemd-networkd

    Luckily, all but the last package are available from the preconfigured RHEL 9 repositories. The last package (systemd-networkd) is available from the EPEL 9 repository and will need to be configured when building the image.

    Build the image

    Navigate to image builder (Figure 1).

    Image builder welcome page
    Figure 1: Image builder welcome page.

    On the upper right menu, enable the Preview mode (Figure 2).

    Image builder welcome page in preview mode
    Figure 2: Image builder welcome page in preview mode.

    Click Add blueprint to open the Create image dialog wizard (Figure 3).

    Image builder create image page
    Figure 3: New image output options page.

    On the Image output page, select the following:

    • From the Release list, select Red Hat Enterprise Linux (RHEL) 9.
    • From the Select target environments option, select WSL - Windows Subsystem for Linux (`.tar.gz`).
    • Click Next.

    On the Register page, select Automatically register and enable advanced capabilities.

    • From the dropdown menu, choose an activation key to use for the image. See Creating an activation key.
    • Click Next.

    On the OpenSCAP page, as it is not supported for WSL images, click Next.

    On the File system configuration page, select Recommended: Use automatic partitioning.

    • Click Next.

    On the Content page, complete the following steps to add additional packages to your image:

    • On the Repository snapshot step:
      • Select Use latest content.
      • Click Next.
    • On the Custom repositories step, shown in Figure 4, click the Create and manage repositories here link.

      Image builder custom repositories page
      Figure 4: New image custom repositories page.
    • This will open a new tab (Figure 5).

      Console repositories management
      Figure 5: Repositories management welcome page.

    Click Add repositories now (Figure 6).

    Console add repositories page
    Figure 6: New repositories page.

    Click Add repositories (Figure 7).

    Console add repository page
    Figure 7: New repository options page.

    On the Add custom repositories page, select the following:

    • In the Name list, enter EPEL 9.
    • In the URL field, enter: https://dl.fedoraproject.org/pub/epel/9/Everything/x86_64/
    • In the GPG key field, enter: https://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-9
    • Click Save.

    Close the tab and switch back to the previous one.

    • In the filter input field, type EPEL.
    • Select the EPEL 9 repository as shown in Figure 8.
    Console repository created page
    Figure 8: New repository added page.

    Click Next.

    • On the Additional packages step:
      • On the Available packages search field, enter podman and click the → button.
      • Select the podman and podman-docker packages.
      • On the Available packages search field, enter procps-ng and click the → button.
      • Select the procps-ng package.
      • On the Available packages search field, enter openssh-server and click the → button.
      • Select the openssh-server package.
      • On the Available packages search field, enter net-tools and click the → button.
      • Select the net-tools package.
      • On the Available packages search field, enter iproute and click the → button.
      • Select the iproute package.
      • On the Available packages search field, enter dhcp-client and click the → button.
      • Select the dhcp-client package.
      • On the Available packages search field, enter sudo and click the → button.
      • Select the sudo package and click the > button to add the selected package shown in the package search results to the Chosen packages dual list box.
      • On the Available packages search field, enter systemd and click the → button.
      • Select the systemd-networkd package.
      • Click Next.

    On the First boot script configuration page, click Next.

    On the Details page:

    • In the Blueprint name, enter rhel-wsl.
    • Click Next.

    On the Review page:

    • Click Create blueprint and build image (Figure 9).
    Image builder built images page
    Figure 9: Image builder images list.

    The image is being built. Once the build is finished, the download link will be available. Click the Download (.tar.gz) link and save the downloaded file to one of your local folders.

    Create the RHEL WSL Podman machine

    Launch Podman Desktop and go to the Settings → Resources page, as shown in Figure 10.

    Podman Desktop resources page
    Figure 10: Podman Desktop resources page.

    On the Podman provider, click Create new ...

    On the Create Podman machine page, click the Browse button for the Image Path field and select the file downloaded from image builder. See Figure 11.

    Podman Desktop create Podman machine page
    Figure 11: The new Podman machine page in Podman Desktop.

    Click the Create button. The machine will be created and started. After a short time, the operation status should be reported, as depicted in Figure 12.

    Podman Desktop Podman machine created
    Figure 12: Podman Machine new machine created page.

    Let's play with the RHEL WSL Podman machine

    Go to the Images page and pull the httpd image (Figure 13).

    Podman Desktop pull image page
    Figure 13: Podman Desktop pull image page.

    Click Done (Figure 14).

    Podman Desktop images list page
    Figure 14: Podman Desktop images list page.

    Start the image by clicking on the Run image icon (Figure 15).

    Podman Desktop start container page
    Figure 15: Podman Desktop create container options page.

    Once the container is started, you can access the Apache server on http://localhost:9000.

    Related Posts

    • Getting started with RHEL on WSL

    • Rootless containers with Podman: The basics

    • Podman and Buildah for Docker users

    • Containerize .NET for Red Hat OpenShift: Windows containers and .NET Framework

    • Create a Windows golden image for OpenShift Virtualization

    Recent Posts

    • Federated identity across the hybrid cloud using zero trust workload identity manager

    • Confidential virtual machine storage attack scenarios

    • Introducing virtualization platform autopilot

    • Integrate zero trust workload identity manager with Red Hat OpenShift GitOps

    • Best Practice Configuration and Tuning for Linux and Windows VMs

    What’s up next?

    Read Podman in Action for easy-to-follow examples to help you learn Podman quickly, including steps to deploy a complete containerized web service.

    Get the e-book
    Red Hat Developers logo LinkedIn YouTube Twitter Facebook

    Platforms

    • Red Hat AI
    • Red Hat Enterprise Linux
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products

    Build

    • Developer Sandbox
    • Developer tools
    • Interactive tutorials
    • API catalog

    Quicklinks

    • Learning resources
    • E-books
    • Cheat sheets
    • Blog
    • Events
    • Newsletter

    Communicate

    • About us
    • Contact sales
    • Find a partner
    • Report a website issue
    • Site status dashboard
    • Report a security problem

    RED HAT DEVELOPER

    Build here. Go anywhere.

    We serve the builders. The problem solvers who create careers with code.

    Join us if you’re a developer, software engineer, web designer, front-end designer, UX designer, computer scientist, architect, tester, product manager, project manager or team lead.

    Sign me up

    Red Hat legal and privacy links

    • About Red Hat
    • Jobs
    • Events
    • Locations
    • Contact Red Hat
    • Red Hat Blog
    • Inclusion at Red Hat
    • Cool Stuff Store
    • Red Hat Summit
    © 2026 Red Hat

    Red Hat legal and privacy links

    • Privacy statement
    • Terms of use
    • All policies and guidelines
    • Digital accessibility

    Chat Support

    Please log in with your Red Hat account to access chat support.