freeCodeCamp/docs/how-to-use-docker-on-windows-home.md
Oliver Eyton-Williams c8d7f0a782
feat(tools): remove eslint-plugin-prettier for prettier (#42438)
* feat: remove eslint-plugin-prettier for prettier

This removes the annoying lint warnings when all that needs to change is
formatting

* fix: use .js lint-staged config to ignore properly

* fix: lint everything if a lot of files are changed

It's faster than making lots of individual linter calls

* chore: apply prettier

* fix: ignore code in curriculum-file-structure
2021-10-06 21:02:21 +05:30

1.3 KiB

How to use Docker on Windows Home

There are a few pitfalls to be avoided when setting up Docker on Windows Home. First of all, you have to use Docker Toolbox as Administrator. Unfortunately Windows Home does not support Docker for Windows Desktop, so Toolbox must be used instead. It has to be run as Administrator as the installation uses symlinks, which cannot be created otherwise.

Once you've installed the toolbox, run Docker Quickstart Terminal as Administrator. This will create a default virtual machine if it does not already exist. Once that has happened, close the terminal and open VirtualBox (again as Administrator). You should be able to see the default machine. The site is quite resource-intensive, so stop the virtual machine and raise the settings as much as you can - memory in particular. It has been confirmed to work with 4GB of ram.

Once you're happy that Docker is working, clone the freeCodeCamp repository to a directory inside C:\Users. These directories are shared giving Docker access to the local directories, which it needs during installation.

If you see messages like

bash: change_volumes_owner.sh: No such file or directory

when you npm run docker:init this is likely the culprit.