Skip to content
This repository was archived by the owner on Jun 16, 2022. It is now read-only.

Installing Docker and Docker Compose

Jump to bottom
Joshua Zenn edited this page Jan 27, 2022 · 2 revisions

Windows

Installation

  1. Go to https://www.docker.com/products/docker-desktop and run the setup.
  2. You may be asked to restart as part of the install if you have never used Windows Virtualization Framework components before.
  3. Verify that Docker was installed correctly by opening Powershell or CMD and running docker -v and docker-compose --version.
  4. Open the Docker Desktop program, and change any settings if needed.

Troubleshooting

If you see errors stating that the Docker engine could not start, try the following.

  • Ensure that WSL 2 is installed (Windows 10 and later).
  • If you have Windows 10/11 Pro or Enterprise, open Powershell as an administrator and run Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All. Restart after the command completes.

If you get an error about a file ending in .sh not existing, run this command instead of docker-compose up: docker-compose up -d --build web db email

MacOS

Installation

  1. Go to https://www.docker.com/products/docker-desktop and run the setup.
  2. You may be prompted to allow a kernel extension called Hyperkit. It is an Apple framework, so it is safe to allow.
  3. Verify that Docker was installed correctly by opening the terminal and running docker -v and docker-compose --version.
  4. Open the Docker Desktop program, and change any settings if needed.

Troubleshooting

Check the Security & Privacy section of the settings app to see if anything was blocked.

Linux

Installation

See the documentation if you are not running a Debian-based distribution.

sudo apt-get install -y ca-certificates curl gnupg lsb-release
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
sudo curl -L "https://github.com/docker/compose/releases/download/v1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Verify that everything was installed correctly with docker -v and docker-compose --version.

Troubleshooting

Google is your friend, good luck.

Clone this wiki locally