The latest version of the Divio App now uses the new native Docker for Mac or Docker for Windows applications by default, which make both Docker Toolbox and VirtualBox unnecessary. The new set-up is much more robust and reliable than the old Divio App/Docker Toolbox/VirtualBox combination.

Instead of running your project in a VirtualBox virtual machine managed by Docker Toolbox, the new Docker applications run the Docker containers natively on your system.

If your system does not support the new Docker application, then the Divio App will continue to use the old Docker Toolbox/VirtualBox set-up. See Requirements below for details.

If you encounter problems running Docker Toolbox/Virtualbox on your Windows environment, please check out Docker Kitematic's Common Issues and Fixes section.

What to do

  1. Launch the Divio App. It will download any available updates. (You can also download the latest versions directly: Divio App for Macintosh or Divio App for Windows.)
  2. If you have any projects with data in their local database that you want to keep, push each one to the Divio cloud, with divio project push db or by using Upload database in the Divio App.
  3. Stop any running project. Quit the application. 
  4. In VirtualBox, shut down all your virtual machines. Quit VirtualBox.
  5. Download and install Docker for Mac or Docker for Windows as appropriate.
  6. Launch the Docker application. Allow it to copy containers and images if it asks.
  7. Launch the Divio App.
  8. For each project, you will need to run divio project pull db or Download database in the Divio App to download the database again.


  • From this point onwards, always make sure that Docker is running before trying to use the Divio App.
  • You will know that your system is using the native Docker application when your local Divio projects open at instead of as they did previously.


Note that you will only be able to use the native Docker application if your system supports it.

Macintosh requirements 

  • Mac OS X 10.10.3 Yosemite or newer
  • a 2010 or newer model Macintosh 

Windows requirements

  • 64bit Windows 10 Pro, Enterprise or Education (1511 November update, Build 10586 or later)
  • Microsoft Hyper-V must be enabled

The requirements are listed in detail on the respective download pages (see Docker for Mac, Docker for Windows).

Did this answer your question?