Kitematic: Known issues
Estimated reading time: 1 minute
Legacy desktop solution. Kitematic is a legacy solution, bundled with Docker Toolbox. We recommend updating to Docker Desktop for Mac or Docker Desktop for Windows if your system meets the requirements for one of those applications.
The most common errors with Kitematic occur at the setup stage since creating a VM reliably with VirtualBox can be tricky. We are working on this problem.
Below are a list of common errors and solutions that work for most people.
Setup error or hanging at 99%
Sometimes Kitematic doesn’t set up VirtualBox properly. Retrying the setup usually works (via one of the two retry buttons). If not, try the following commands on the command line:
docker-machine rm -f dev
docker-machine create -d virtualbox dev
Then re-open Kitematic. This usually fixes the issue, but if it persists, feel free to view our existing GitHub issues.
We’re always looking for help to make Kitematic better and more reliable! Visit our GitHub page for docs on how to contribute.
Under the hood, Kitematic uses Docker Machine to provision Docker-enabled VMs via VirtualBox. We’re still working on a stronger integration with this project. Their GitHub repo is a great place to start if you’re looking to help fix specific issues around VM provisioning.
View all issues
For a full list of Kitematic bugs or issues see our existing GitHub issues labeled as