About this Install Guide

This guide is intended to get you up and running with this tool quickly with the most common settings. For a thorough review of all options, refer to the official documentation.

AWS Copilot CLI is an open source command line interface for running containers on AWS App Runner, Amazon Elastic Container Service (ECS), and AWS Fargate.

It is available for a variety of operating systems and Linux distributions and supports the Arm architecture.

Before you begin

This article provides quick solutions to install the latest version of AWS Copilot CLI for Ubuntu on Arm and macOS.

Confirm you are using an Arm computer by running:


            uname -m

If you are on Arm Linux the output should be:




If you are on macOS with Apple Silicon the output should be:




Download and install AWS Copilot CLI

Copilot requires Docker. Refer to the Docker install guide for installation instructions.

If you are using Docker on Linux you will need to install QEMU to build container images for both the arm64 and the amd64 architectures.


            sudo apt-get install qemu-user-static

Docker Desktop for macOS includes the ability to build for multiple architectures, so you don’t need to do anything extra.

To install Copilot on Arm Linux:


            sudo curl -Lo /usr/local/bin/copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64 \
   && sudo chmod +x /usr/local/bin/copilot \
   && copilot --help

To install Copilot on macOS:


            curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help

Verify Copilot CLI is installed by running:


            copilot --version

The version should be printed:


        copilot version: v1.33.0



How would you rate the overall quality of this tool quick-install guide?