Skip to main content

Docker Installation Guide

Linux (Ubuntu/Debian)

The following commands are tested on Ubuntu 22.04 and Ubuntu 24.04 in our CI pipeline:

install-docker.sh
# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# Clean up
rm get-docker.sh

After installation, you'll need to either log out and back in, or use newgrp docker to apply the group membership.

macOS

The following commands are tested on macOS in our CI pipeline:

install-docker-macos.sh
# Install Docker Desktop for Mac
# Note: This requires manual download and installation
echo "Docker Desktop for Mac needs to be installed manually."
echo "Please download it from: https://www.docker.com/products/docker-desktop/"
echo "Alternatively, you can use Homebrew Cask:"
echo "brew install --cask docker"

# Install Docker via Homebrew Cask (user will need to start Docker Desktop manually)
brew install --cask docker

Note: After installation, you need to manually start Docker Desktop from Applications or Launchpad.

Windows

For Windows, manually download and install Docker Desktop for Windows.

Manual Verification

After installation, verify Docker is working:

docker --version
docker run hello-world

Alternative Manual Installation

If you prefer not to use the automated scripts, you can find manual installation instructions in Docker's official documentation:

Testing

These installation scripts are tested nightly and on-demand in our CI pipeline to ensure they remain functional across different environments. You can see the test results in the Documentation Scripts workflow.