Docksal supports two operation modes on Mac and Windows:
Open a web browser and navigate the Docker Desktop for Mac install page. Click the button corresponding to the type of processor your Mac has. When downloaded, click the disk image file to run the Docker Desktop installer. A menu screen will open with the Docker Desktop app and the Applications folder on your Mac. When running Docker Toolbox, Docker Machine via VirtualBox or any VirtualBox VM (like a Vagrant definition) you can setup a “Host-Only Network” and access the Docker VMs network via that. If you are using the default boot2docker VM, don’t change the existing interface as you will stop a whole lot of Docker utilities from working, add a.
- VirtualBox VM (default)
- Docker Desktop for Mac/Windows
You can switch between these modes at any time using the instructions below.
While preserved in the original instance, Docker data (images, containers, volumes) is not automatically transferred overbetween VirtualBox and Docker Desktop instances. They are completely separate VMs.
Running in both modes at the same time is not supported.
Switching from VirtualBox to Docker Desktop for Mac
Assuming that you have been previously using Docksal with VirtualBox, which was installed according to setup docs:
Stop Docksal VirtualBox VM (run in Terminal):
Install/launch Docker Desktop for Mac
Start Docksal in Docker Desktop mode (run in Terminal):
File sharing with Docker for Mac
Docker for Mac automatically shares most commonly used volumes/directories. As of Docksal 1.13.0, thisis done through NFS. See Docker documentation for details.It is usually not necessary to adjust these settings, but you want to set the DOCKSAL_NFS_PATH value in the
~/.docksal/docksal.env file if your Home folder is not in a usual place. See File Sharing.
Docksal automatically enables the
osxfs:cached mode on Docker for Mac, which improves the file system read performancesubstantially. On Mac,
osxfs:cached mode for Docker for Mac provides a decent read performance (still not as fast as NFS, butgetting there). See docksal/docksal#249
Switching from Docker Desktop for Mac to VirtualBox
Stop Docksal in Docker Desktop (run in Terminal):
Quit Docker Desktop app
Start Docksal in VirtualBox VM mode (run in Terminal):
Switching from VirtualBox to Docker Desktop for Windows
Stop Docksal VirtualBox VM (run in WSL):
Install/launch Docker Desktop for Windows.
Start Docksal in Docker Desktop mode (run in WSL):
File sharing on Windows for Docker for Windows
Share your local drives with Docker for Windows:
Switching from Docker Desktop for Windows to VirtualBox
Stop Docksal in Docker Desktop (run in WSL):
Quit Docker Desktop app
You will also have to completely uninstall Hyper-V (a dependency for Docker Desktop for Windows).
You won’t be able to use VirtualBox (or any other hypervisor) while Hyper-V is installed.Hyper-V locks the VT-x extension to itself, so other hypervisors are not able to use the hardware virtualizationsupport and cannot run 64bit VMs because of that.
Start Docksal in VirtualBox VM mode (run in WSL):
If you're running macOS or Windows you have a few options for installing Docker. There's even a third way too, and we'll compare them here.
Quick Jump: OS and Hardware RequirementsPros and ConsWhich One Should I Use?
If you’re on macOS or Windows you can install Docker with:
- Docker for Mac / Windows (now known as Docker Desktop)
- Docker Toolbox
- Running your own Virtual Machine and installing Docker yourself
All 3 of those options have their own pros and cons and in this article we’re going to cover them. If you’re looking for a high level overview of what Docker for Mac / Windows and Docker Toolbox is, then check out this article on getting to know Docker’s ecosystem.
OS and Hardware Requirements
It’s helpful to know what you can install before we compare everything, so let’s do that:
Docker for Mac (Docker Desktop)
Docker for Mac requires that you’re running Mojave 10.14+ or newer with an Intel CPU. M1 support is on its way.
You can run VirtualBox 6+ alongside Docker Desktop. This is pretty useful because you might have some legacy apps running in Vagrant / VirtualBox to deal with (I know I do!).
Docker for Windows (Docker Desktop)
As of May 27th 2020, Microsoft released Windows 10 build 2004 (Spring 2020) that allows you to run Docker Deskop on all editions of Windows 10, including Home thanks to WSL 2.
As of August 2020, Microsoft enabled WSL 2 support for Windows 10 builds 1903 + 1909.
Mac Virtualbox Docker Download
For years prior to that you could only run it on Windows Pro, Enterprise or any edition that had Hyper-V available, but since August 2020 pretty much all supported versions of Windows 10 can use Docker Desktop.
You can also run VirtualBox 6+ alongside Docker Desktop too in case you have older projects using VirtualBox (perhaps with Vagrant too).
Prior to mid-2020 this was still a reasonable way to run Docker on machines that couldn’t run Docker Desktop, but that’s no longer the case.
It’s now considered legacy and as of late 2020 it’s been officially deprecated.
Unless you’re using unsupported versions of Windows or have a really really ancient Mac you shouldn’t need to ever use this tool.
But if you’re in a pinch and you absolutely must use it, technically it’s still available at https://github.com/docker/toolbox/releases, but it’s no longer maintained by Docker.
Your own Virtual Machine
Docker will happily run inside of VirtualBox, VMWare Workstation or any other Type 1 / 2 Hypervisor that’s running a major distribution of Linux as a guest OS.
If for whatever reason you can’t use Docker Desktop then this solution would be better than using Docker Toolbox since you can install supported versions of Docker and you have full control over the environment.
Pros and Cons
Now for the good stuff!
Docker for Mac / Docker for Windows (Docker Desktop)
Offers the most “native” experience, you can easily use any terminal you you want since Docker is effectively running on
localhostfrom macOS / Windows’ POV.
Docker is heavily developing and polishing this solution.
On certain macOS hardware combos the volume performance can be a little slow.
I can legit say there are not any “wow this sucks!” cons for Windows, it’s really solid.
- Offers an “out of the box” Docker experience if you have no other choice.
It’s deprecated by Docker and will receive no future maintenance.
You need to either use the Docker Quickstart Terminal, or configure your own terminal to connect to the Docker Daemon running a VM.
Not a native solution, so you’ll need to access your Docker Machine’s IP address if you’re developing web apps. Example:
Unless you jump through hoops, your code needs to live in your Windows user directory such as
C:UsersNicksrcmyapp. Otherwise Docker won’t be able to find it.
Suffers from typical VirtualBox edge case bugs and mount performance issues.
Your own Virtual Machine
I’m not going to bother listing a pros and cons here because I wouldn’t recommend doing this UNLESS you’re stuck on Windows 7 / 8 or an older version of Windows 10 like 1809.
But more on that in a bit.
Mac Virtualbox Docker Key
Which One Should I Use?
If you’re interested in Docker, you’re a smart person and you probably came to the conclusion that using Docker for Mac or Docker for Windows is a good idea as long as you can run it.
Mac Virtualbox Docker Download
My recommendation would be to try Docker for Mac / Windows first, and test it against your actual use cases. The performance issues may or may not be a concern, especially since everyone’s needs and computer specs are different.
I’ve been using Docker Desktop on Windows for full time development since late 2018 and it’s been nothing short of fantastic. Currently I use it with WSL 2, but it was really good with WSL 1 along with Hyper-V too.
Stuck on an Old Version of Windows and Like Linux?
I want to mention a “roll your own VM” solution for Windows users because I feel like there’s an even better way to run Docker on Windows if you also like Linux and are stuck not being able to use modern versions of Windows 10.
It involves running VMWare Player in a special mode called “Unity mode”. This basically allows you to run Windows and Linux together seamlessly as 1 operating system.
There’s no dual booting and Linux applications (even graphical apps) run in their own floating windows. Then you can install Docker natively on Linux inside of the VM.
The performance is excellent and the entire set up is free too.
I used this set up for about 5 years until Docker Desktop was available. It gives you the best of both worlds. For example, I run high end audio / video apps on Windows while recording courses and screencasts that cover Linux content. It all works great (even for full time development).
You can watch a video guide and see screenshots on how to do that in this post on creating an awesome Linux development environment in Windows.
Are you using the Docker Toolbox, Docker for Mac / Windows or your own VM?