Troubleshooting SMB shares creation, mounting, and related issues on Windows
SMB related errors happen during VM start and look like one of the following:
Configuring SMB shares... Enter your Windows account password: mount: mounting //192.168.64.1/docksal-c on /c failed: Connection refused exit status 255
Configuring SMB shares... Enter your Windows account password: mount: mounting //192.168.64.1/c on /c failed: Operation now in progress... exit status 255
If you ignored these errors and tried to start a project, then it will most likely fail with an error like this:
ERROR: for cli Cannot create container for service cli: error while mounting vo lume with options: type='none' device='/c/Users/alex/projects/myproject' o='bind': no such file or directory ERROR: Encountered errors while bringing up the project.
During VM start Docksal creates shares for all your local drives,
If share creation fails, Docker will not be able to access your files.
Even if shares were created successfully, mounting them from within the VM may still fail for some reason. In that case, Docker also will not be able to access your files.
If you use Docker Desktop application check that you have shared the drive with Docker Desktop application.
When Docksal VM is being created, VirtualBox needs to configure network adapter and requires administrative permissions for that. Those elevated prompts are sometimes appear minimized on the taskbar. Pay attention to them and reply Yes. There are warning about this in console:
(docksal) Check network to re-create if needed... (docksal) Windows might ask for the permission to create a network adapter. Sometimes, such confirmation window is minimized in the taskbar. (docksal) Found a new host-only adapter: "VirtualBox Host-Only Ethernet Adapter #2" (docksal) Windows might ask for the permission to configure a network adapter. Sometimes, such confirmation window is minimized in the taskbar. (docksal) Windows might ask for the permission to configure a dhcp server. Sometimes, such confirmation window is minimized in the taskbar.
If you ignored those elevated requests or got distracted and they had timed out,
or if you accidentally replied No, then the adapter fail to set up properly and
your only option would be to remove vm with
fin vm remove and start it again.
Determine your local IP address. Usually you can do that by running
looking for an active adapter that has “Local Area Connection” in the name.
Open explorer and navigate to
It should open with no errors and you should see your network shares.
Usually there are some shares, but you may have none. If there is no shares but IP opens without any error messages, then you should be good with this step.
But if you get errors when trying to access IP, then there is an issue with your Windows network settings and you need to fix it. Docksal can not fix it for you, because there are dozens of reasons why it might fail to work.
The most usual case is “Files and Printer sharing” being not enabled. Enable it in network settings and try opening that IP again.
If after enabling files sharing you still can not access your IP via Explorer, then see this elaborate post on superuser about issues with File/Printer sharing on Windows. Hopefully it helps. Do not proceed to next steps if you have not fixed the issue because they will fail too.
Friendly reminder: if everything fails to make it working, then you might be limited to re-installing Windows. We test Docksal on a clean Windows 10 installation and make sure it works.
NOTE: At this step we assume you had already run
fin system start and it had failed
with error related to shares or mounting. You checked out the first step and there seems to be no
issues with accessing your local IP via explorer. (If error with vm
start is not related to mounting or shares, then see regular troubleshooting guide.)
In this step you need to check access to Docksal IP. Open explorer and navigate to
This is the IP that VirtualBox adapter assigns to your host machine. Just like in the previous step, it
should open with no errors and now you should see your network shares.
If you get errors when trying to open it, then there is an issue with VirtualBox network adapter. The
most common reason is Windows Firewall blocking it. Try disabling your Firewall and check if it
helps. If disabling firewall helped, then you either need to keep it this way or create an
incoming rule for your firewall to allow all traffic to all ports from IP
If you disabled Windows Firewall, but you still can not access this IP address, then it is not firewall to blame. You would need to refer to the same elaborate post on superuser about issues with File/Printer sharing on Windows.
In worst case try removing Docksal VM with
fin vm remove, uninstall VirtualBox, reboot, install
VirtualBox and start vm again.
If all options fail, you might be limited to re-installing Windows. We had cases when people had mysterious issues related to shares mounting. They re-installed Windows and everything worked like a charm.
If both IPs are working, then it’s not the network access issue.
Open explorer and navigate to
\\192.168.64.1\. Make sure that you see and can
access shares that Docksal should have created for your local drives.
If you see the shares but can not access them, then most likely you hit some edge case. Easiest fix is to stop Docksal VM, remove those shares manually using Windows UI and start VM back again.
If you don’t see those shares altogether, then there is an issue with shares creation.
Possible common reasons:
Check your password. Check that you can create shares, but do not create Docksal shares manually unless you know which permissions to set.
fin vm restart. If the issue with share creation does not go away and you think
it not password or policies, then see step 6.
For Microsoft Account use Microsoft Account password not the one you use to unlock your PC.
Your password can NOT contain:
\ (back slash) or
' (single quote) symbol
because the password is being passed to the console mount command.
Other special symbols are not an issue, but in case your password contains some other special
symbols and you see errors that contain
... Configuring SMB shares... Enter your Windows account password: mount: mounting //192.168.64.1/docksal-c on /c failed: Invalid argument exit status 255 Mount command failed... Trying an alternative method... mount: mounting //192.168.64.1/docksal-c on /c failed: Invalid argument exit status 255
In this case, try simplifying your password. If it works with a new password, then create an issue on GitHub (see step 6), so we could investigate and fix.
If you checked all the steps above and it didn’t help, then report an issue on GitHub and we will investigate the edge case.
If you have questions on resolving issues with steps above, try searching the issue queue or
if you are stuck, you can also create an issue on GitHUb to ask a question. Describe which step
you stumbled on, what fails, what is the error, what did you try to resolve it, and provide the output
you are getting and the
fin sysinfo output.