# [AWS Copilot CLI](https://learn.arm.com/install-guides/aws-copilot/)

## About this Install Guide

| Reading time: | 10 min |
|---------------|--------|
| Last updated: | 22 Jun 2026 |

| Author:       | Jason Andrews, Arm [GitHub](https://github.com/jasonrandrews) [LinkedIn](https://linkedin.com/in/jason-andrews-7b05a8) |
|---------------|----------------|
| Official docs:| [View](https://aws.github.io/copilot-cli/) |

This guide shows you how to install and use the tool with the most common configuration. For advanced options and complete reference information, see the official documentation. Some install guides also include optional next steps to help you explore related workflows or integrations.

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.

## What do I need before installing AWS Copilot CLI?

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:

```bash
uname -m
```

If you are on Arm Linux the output should be:

```
__output__ aarch64
```

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

```
__output__ arm64
```

## How do I download and install AWS Copilot CLI?

Copilot requires Docker. Refer to the [Docker](https://learn.arm.com/install-guides/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.

```bash
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:

```bash
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:

```bash
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
```

The help message is printed:

```
__output__ 👩‍✈️ Launch and manage containerized applications on AWS.
__output__ 
__output__ Commands
__output__   Getting Started 🌱
__output__     init        Create a new ECS or App Runner application.
__output__     docs        Open the copilot docs.
__output__ 
__output__   Develop ✨
__output__     app         Commands for applications.
__output__                 Applications are a collection of services and environments.
__output__     env         Commands for environments.
__output__                 Environments are deployment stages shared between services.
__output__     svc         Commands for services.
__output__                 Services are long-running ECS or App Runner services.
__output__     job         Commands for jobs.
__output__                 Jobs are tasks that are triggered by events.
__output__     task        Commands for tasks.
__output__                 One-off Amazon ECS tasks that terminate once their work is done.
__output__     run         Run the workload locally.
__output__ 
__output__   Release 🚀
__output__     pipeline    Commands for pipelines.
__output__                 Continuous delivery pipelines to release services.
__output__     deploy      Deploy one or more Copilot jobs or services.
__output__ 
__output__   Extend 🧸
__output__     storage     Commands for working with storage and databases.
__output__     secret      Commands for secrets.
__output__                 Secrets are sensitive information that you need in your application.
__output__ 
__output__   Settings ⚙️
__output__     version     Print the version number.
__output__     completion  Output shell completion code.
__output__ 
__output__ Flags
__output__   -h, --help      help for copilot
__output__   -v, --version   version for copilot
__output__ 
__output__ Examples
__output__   Displays the help menu for the "init" command.
__output__   `$ copilot init --help`
```

## How do I verify AWS Copilot CLI installation?

Verify Copilot CLI is installed by running:

```bash
copilot --version
```

The installed version is displayed:

```
__output__ copilot version: v1.34.0
```