Skip to content

Instantly share code, notes, and snippets.

@npearce
Last active April 24, 2026 20:03
Show Gist options
  • Select an option

  • Save npearce/6f3c7826c7499587f00957fee62f8ee9 to your computer and use it in GitHub Desktop.

Select an option

Save npearce/6f3c7826c7499587f00957fee62f8ee9 to your computer and use it in GitHub Desktop.
Amazon Linux 2 - install docker & docker-compose using 'sudo amazon-linux-extras' command

UPDATE (March 2020, thanks @ic): I don't know the exact AMI version but yum install docker now works on the latest Amazon Linux 2. The instructions below may still be relevant depending on the vintage AMI you are using.

Amazon changed the install in Linux 2. One no-longer using 'yum' See: https://aws.amazon.com/amazon-linux-2/release-notes/

Docker CE Install

sudo amazon-linux-extras install docker
sudo service docker start
sudo usermod -a -G docker ec2-user

Make docker auto-start

sudo chkconfig docker on

Because you always need it....

sudo yum install -y git

Reboot to verify it all loads fine on its own.

sudo reboot

docker-compose install

Copy the appropriate docker-compose binary from GitHub:

sudo curl -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

NOTE: to get the latest version (thanks @spodnet): sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

Fix permissions after download:

sudo chmod +x /usr/local/bin/docker-compose

Verify success:

docker-compose version

@fefogarcia

Copy link
Copy Markdown

This saved me, thank you

@Geczy

Geczy commented Apr 27, 2023

Copy link
Copy Markdown

@vincenthsh 's solution worked for me as sudo

@MarwenAouiti

MarwenAouiti commented May 29, 2023

Copy link
Copy Markdown

wget https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)
sudo mv docker-compose-$(uname -s)-$(uname -m) /usr/local/bin/docker-compose
sudo chmod -v +x /usr/local/bin/docker-compose

@sahilsheikh-dev

Copy link
Copy Markdown

sudo curl -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Note:
For me, uname -s returned Linux, but the download URL has linux so please replace it.
Also, uname -m returned x86_64 so replace that as well

Example:
sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

@AustinGilkison

Copy link
Copy Markdown

Had an issue around the permissions command.
sudo usermod -a -G docker ec2-user

permission denied while trying to connect to the Docker daemon socket at .....

This seemed to be the fix:
sudo usermod -aG docker $USER

@OlliKantola

Copy link
Copy Markdown

Works like a charm. Thank you.

@itbrunoms

Copy link
Copy Markdown

The best anwser!!

@ShamalMuneer007

Copy link
Copy Markdown

THANK YOU!!!!

@kevindai007

Copy link
Copy Markdown

Thanks a lot, but for this command
sudo amazon-linux-extras install docker
i believe it should change to
sudo yum install docker

@316usman

316usman commented Jan 8, 2024

Copy link
Copy Markdown

Thanks docker-compose works great

@jonassteinberg1

Copy link
Copy Markdown

@tuancuongth88

Copy link
Copy Markdown

Thanks

@NicholasMarks2024

Copy link
Copy Markdown

Thank you.

@realtebo

Copy link
Copy Markdown

thank you !

should we still install manually docker compose?

@realtebo

Copy link
Copy Markdown

I got this

docker: 'compose' is not a docker command.

@aidanhor-n

Copy link
Copy Markdown

If this doesn't work for you for whatever reason, add it to PATH

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

two years later, my savior

@sharva

sharva commented Dec 17, 2025

Copy link
Copy Markdown

If you are getting buildx error on Amazon Linux 2023, following helps

e.g. error compose build requires buildx 0.17 or later

# Check current version
docker buildx version

# Download and install latest buildx
BUILDX_VERSION=$(curl -s https://api.github.com/repos/docker/buildx/releases/latest | grep -oP '"tag_name": "\K[^"]+')
mkdir -p ~/.docker/cli-plugins
curl -Lo ~/.docker/cli-plugins/docker-buildx "https://github.com/docker/buildx/releases/download/${BUILDX_VERSION}/buildx-${BUILDX_VERSION}.linux-amd64"
chmod +x ~/.docker/cli-plugins/docker-buildx

# Verify
docker buildx version

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment