AWS Elastic Beanstalk
Developer Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Install the EB CLI on macOS

If you use the Homebrew package manager, you can install the EB CLI by using the brew command. You can also install Python and pip, and then use pip to install the EB CLI.

Install the EB CLI with Homebrew

The latest version of the EB CLI is typically available from Homebrew a couple of days after it appears in pip.

To install the EB CLI with Homebrew

  1. Ensure you have the latest version of Homebrew.

    $ brew update
  2. Run brew install awsebcli.

    $ brew install awsebcli
  3. Verify that the EB CLI is installed correctly.

    $ eb --version EB CLI 3.14.8 (Python 3.7)

Install Python, pip, and the EB CLI on macOS

You can install the latest version of Python and pip and then use them to install the EB CLI.

To install the EB CLI on macOS

  1. Download and install Python from the downloads page of Python.org. We use version 3.7 to demonstrate.

    Note

    The EB CLI requires Python 2 version 2.7, or Python 3 version in the range of 3.4 to 3.7.

  2. Install pip with the script that the Python Packaging Authority provides.

    $ curl -O https://bootstrap.pypa.io/get-pip.py $ python3 get-pip.py --user
  3. Use pip to install the EB CLI.

    $ pip3 install awsebcli --upgrade --user
  4. Add the executable path, ~/Library/Python/3.7/bin, to your PATH variable.

    To modify your PATH variable (Linux, Unix, or macOS):

    1. Find your shell's profile script in your user folder. If you are not sure which shell you have, run echo $SHELL.

      $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
      • Bash.bash_profile, .profile, or .bash_login.

      • Zsh.zshrc

      • Tcsh.tcshrc, .cshrc or .login.

    2. Add an export command to your profile script. The following example adds the path represented by LOCAL_PATH to the current PATH variable.

      export PATH=LOCAL_PATH:$PATH
    3. Load the profile script described in the first step into your current session. The following example loads the profile script represented by PROFILE_SCRIPT.

      $ source ~/PROFILE_SCRIPT
  5. Verify that the EB CLI is installed correctly.

    $ eb --version EB CLI 3.14.8 (Python 3.7)

To upgrade to the latest version, run the installation command again.

$ pip3 install awsebcli --upgrade --user