Switch between Podman and Docker

The Astro CLI automatically runs Podman containers whenever you run a command that requires them. You can switch between Podman and Docker as your container management engine to run Astro CLI commands.

Prerequisites

Docker

Podman

Microsoft Hyper-V enabled. See Install Hyper-V On Windows or Step-By-Step: Enabling Hyper-V on Windows 11.
The latest version of the Windows App Installer.
Windows 10 1709 (build 16299) or later or Windows 11.

Switch between Podman and Docker

To run CLI commands in Docker containers, run the following command:

1 astro config set container.binary docker -g

If you need to switch back to using Podman again, run the following command:

1 astro config set container.binary podman -g

If you want to switch between Docker and Podman on a specific project without changing the global configuration, run these commands without the -g.