Skip to content

Docker Installation

Jump to bottom
Drew edited this page Oct 11, 2018 · 1 revision

Windows & macOS

For Windows 10 Pro or macOS computers, install Docker Desktop:

For versions of Windows other than Windows 10 Pro, we recommend installing a virtualization program like VirtualBox and working inside an Ubuntu 18.04 linux virtual machine.

Windows note:

It is highly recommended that you use a Unix based machine instead of a Windows OS machine, if possible. This will avoid participants getting too hung up in particularities about Docker installations and configurations.

Linux

For Linux, find your version in the Docker Community Edition product page and click through to find instructions:

Linux notes:

  • If you can, we recommend installing the latest from the docker repos, not the versions that are included in base OS repositories.

  • Consider adding your user to the "docker" OS group so you can manage docker without having to be root (from https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user)_:

    • Add group docker (sudo groupadd docker) - your OS might create it as part of install. If so, you'll get an error message something like "groupadd: group 'docker' already exists". This is fine. No harm no foul. Proceed to the next step.

    • Add your user to the docker group (sudo usermod -aG docker $USER).

    • Log out and log back in. On a VM, you might have to reboot the VM for this to stick (from the doc, not sure why).

    • Try running docker without sudo.

    • If you initially ran docker commands as root, you might see error "WARNING: Error loading config file: /home/user/.docker/config.json - stat /home/user/.docker/config.json: permission denied". This means your ~/.docker folder is owned by root. To fix, either remove ~/.docker and run a docker command to recreate (you'll lose custom settings), or change owner for the folder and all children to your user and default group and update all permissions to the normal umask default (group rwx):

        $ sudo chown "$USER":"$USER" /home/"$USER"/.docker -R
  $ sudo chmod g+rwx "$HOME/.docker" -R(`chown -R `)
Clone this wiki locally