Install Docker Desktop

The first step in getting our SingleStore cluster running in Docker Desktop is to get Docker Desktop installed. If you already have a recent version of Docker Desktop, you need only ensure you’re in Linux containers mode.

Docker’s install requirements are quite specific, though most modern mid-range systems will do. Docker Desktop for Windows runs a Linux VM in Hyper-V, and Hyper-V requires Windows 10 Pro or Enterprise. Docker Desktop for Mac runs a Linux VM in xhyve, and requires a 2010 or newer model with macOS 10.13 or better.

To install Docker Desktop, go to Docker Hub and choose the Docker Desktop version for your operating system. The download will require you to create a free account. Run the downloaded installer and accept all the defaults.

Windows containers can run SingleStore too.

Note for Windows users: If you are doing a fresh install, ensure you choose Linux Containers mode. If you installed Docker previously, ensure you’re running in Linux Containers mode. Right-click on the Docker whale icon in the system tray (bottom-right by the clock), and choose Switch to Linux Containers. If it says Switch to Windows Containers, you’re already in Linux Containers mode.


Adding more RAM: Though not required, SingleStore will definitely perform better when Docker Desktop has more capacity. Click on the Docker whale icon, choose "Settings..." on Windows or "Preferences..." on Mac, and click on the "Advanced" tab. If your machine has more than 8GB RAM, set this to 8192. If your machine has 8GB RAM or less, set it as high as you can. Then change the CPU count from 2 to 4.

Last modified: April 3, 2023

Was this article helpful?