For this tutorial you will need to have git, docker, docker-compose and a web browser installed on your local machine. This tutorial has been tested on various versions of Linux, MacOS, and Windows 10 with the following package versions:
- git 2.17+ (Windows users we recommend: https://gitforwindows.org/)
- docker version 19.03.8+
- docker-compose 1.25.2+
NOTE: For Windows, if you haven't already done so, you will need to configure git not to convert line endings into Windows format. Run this command using the git-bash shell application before cloning the tutorial repo:
git config --global core.autocrlf input
https://docs.docker.com/engine/install/
NOTE: You'll need to make sure the account you're running docker with is in the 'docker' group
https://docs.docker.com/compose/install/
docker info
This should display your system info along with Docker-specific info. If there are any errors, stop/start Docker. Do NOT proceed with the tutorial until you are sure you have a working Docker setup
If you get this error when starting the tutorial
ERROR: Couldn't connect to Docker daemon at http+docker://localunixsocket - is it running?
or
ERROR: Couldn't connect to Docker daemon at http+docker://localhost - is it running?
Try stopping and starting Docker (restart doesn't usually fix the problem). Commands for this differ depending on operating system.
If the error persists, try:
export DOCKER_HOST=127.0.0.1
NOTE: this is only necessary on some systems so don't use it if the previous command works
Some useful info on installing Docker, navigating this tutorial and learning a bit about docker-compose
Docker Tips
Docker Compose Tutorial Unaffiliated with us but a very good overview of Docker Compose