Skip to content

Scan on Windows 10 with WSL 2 and podman

WSL 2 in available on Windows 10, version 2004, Build 19041 or higher. Podman is a daemonless container engine for developing and running OCI containers. It is possible to run scan on Windows 10 with WSL2 and podman without the need for installing docker desktop. Without a running docker daemon, more CPU and RAM are available for your development needs.

Installing WSL2

Follow the instructions here to either install or update to WSL2.

Install Ubuntu 20.04 LTS

Ubuntu 20.04 LTS is one of the supported distro for both WSL2 and podman. If you are planning to use an existing Ubuntu WSL 1 installation, please ensure it is upgraded to WSL 2.

wsl --list --verbose
wsl --set-version <distribution name> <versionNumber>

Installing podman and dependencies

Install podman using the below the commands as mentioned here

. /etc/os-release
sudo sh -c "echo 'deb${VERSION_ID}/ /' > /etc/apt/sources.list.d/devel:kubic:libcontainers:testing.list"
curl -L${VERSION_ID}/Release.key | sudo apt-key add -
sudo apt-get update -qq
sudo apt-get -qq -y install podman build-essential fuse-overlayfs

Configuring podman

We need to make couple of changes to podman configuration. Edit the file /usr/share/containers/containers.conf or /etc/containers/containers.conf and change:

  • cgroup_manager to "cgroupfs"
  • events_logger to "file"
cgroup_manager = "cgroupfs"
events_logger = "file"

Set alias for docker

Add the below alias to your ~/.bashrc or ~/.zshrc

alias docker=podman

Restart the shell for the alias to take effect.

Running scan

Run scan using the same docker commands as mentioned in the getting-started

docker run --rm -e "WORKSPACE=${PWD}" -v "$PWD:/app:cached" shiftleft/sast-scan scan

If you do not prefer alias docker then use podman in the above command.

podman run --rm -e "WORKSPACE=${PWD}" -v "$PWD:/app:cached" shiftleft/sast-scan scan

Performance improvements

Configure rootless mode

Follow these instructions to setup rootless mode for podman. Using crun along with with fuse-overlayfs leads to noticeable improvements.

sudo apt install -y libyajl2 libyajl-dev


cannot stat /root/.config/containers/storage.conf error


Podman: there might not be enough IDs available in the namespace error

podman unshare cat /proc/self/uid_map

If you get the below output then proceed with setting setuid bits using chmod as shown:

    0       1000          1
sudo chmod u+s $(which newuidmap)
sudo chmod u+s $(which newgidmap)
podman system migrate
podman unshare cat /proc/self/uid_map

You should now get

    0       1000          1
    1     100000      65536

Last update: January 25, 2023