Preparing to run the XM Cloud foundation template locally

This topic describes the prerequisites for running the XM Cloud foundation template locally on your own machine.

Running Docker on Windows 10

To run Docker on Windows 10, you must have the following:

  • Windows 10 Professional or Enterprise version 1903 or later. For enabling process isolation, you must have version 1909, or later.

  • Enable Hyper-V.

    The Docker Desktop installer enables Hyper-V if necessary, but a machine restart is then required during install.

  • Use Docker Compose V2. You can find more details in the Docker documentation, and this blog post.


When Hyper-V is enabled, VirtualBox no longer works. However, any existing VirtualBox VM images are retained.

Hardware guidelines

The hardware must meet the requirements for running Hyper-V. For complete details, including how to verify compatibility, see Windows 10 Hyper-V System Requirements. To summarize, Hyper-V requires:

  • A 64 bit processor with Second-level address translation (SLAT) and hardware-assisted virtualization.

  • At least 4GB of RAM (see the further requirements for XM cloud that follow).

  • Virtualization support must be turned on in the BIOS.

In addition to the Hyper-V requirements, XM Cloud development has the following further requirements:

  • 16GB of RAM is the minimum, 32GB of RAM is recommended. This depends on the number of instances you want to run (that is, the number of simultaneously running containers).

  • A quad core, or higher, CPU.

  • At least 30GB of free disk space for XM Cloud container images. SSD storage is highly recommended for optimal performance when downloading and running Docker containers.

Do you have some feedback for us?

If you have suggestions for improving this article,