Menu
Amazon EC2 Container Service
Developer Guide (API Version 2014-11-13)

Installing the Amazon ECS CLI

Follow these instructions to install the Amazon ECS CLI on your Mac OSX or Linux system.

Note

The Amazon ECS CLI is not available for Windows systems at this time.

To install the Amazon ECS CLI

  1. Download the binary.

    • For Mac OSX:

      Copy
      sudo curl -o /usr/local/bin/ecs-cli https://s3.amazonaws.com/amazon-ecs-cli/ecs-cli-darwin-amd64-latest
    • For Linux systems:

      Copy
      sudo curl -o /usr/local/bin/ecs-cli https://s3.amazonaws.com/amazon-ecs-cli/ecs-cli-linux-amd64-latest
  2. (Optional) Verify the downloaded binary with the MD5 sum provided.

    • For Mac OSX (compare the two output strings to verify that they match):

      Copy
      curl -s https://s3.amazonaws.com/amazon-ecs-cli/ecs-cli-darwin-amd64-latest.md5 && md5 -q /usr/local/bin/ecs-cli
    • For Linux systems (look for an OK in the output string):

      Copy
      echo "$(curl -s https://s3.amazonaws.com/amazon-ecs-cli/ecs-cli-linux-amd64-latest.md5) /usr/local/bin/ecs-cli" | md5sum -c -
  3. Apply execute permissions to the binary.

    Copy
    sudo chmod +x /usr/local/bin/ecs-cli
  4. Verify that the CLI is working properly.

    Copy
    ecs-cli --version
  5. Proceed to Configuring the Amazon ECS CLI.

    Important

    You must configure the ECS CLI with your AWS credentials, an AWS region, and an Amazon ECS cluster name before you can use it.