AWS Elastic Beanstalk
Developer Guide

Install the Elastic Beanstalk Command Line Interface (EB CLI)

The Elastic Beanstalk Command Line Interface (EB CLI) is a command line client that you can use to create, configure, and manage Elastic Beanstalk environments. The EB CLI is developed in Python and requires Python version 2.7, version 3.4, or newer.


Amazon Linux, starting with version 2015.03, comes with Python 2.7 and pip.

Compatibility notes

The EB CLI and the AWS Command Line Interface (AWS CLI) share a dependency on the botocore Python package. Due to a breaking change in botocore, different versions of these two CLI tools depend on different versions of botocore.

The latest versions of the two CLIs are compatible. If you need to use previous versions, consult the following table to ensure you use compatible versions.

EB CLI version Compatible AWS CLI version

3.14.5 or earlier

1.16.9 or earlier

3.14.6 or later

1.16.11 or later

Install the EB CLI

The primary distribution method for the EB CLI on Linux, Windows, and macOS is pip. This is a package manager for Python that provides an easy way to install, upgrade, and remove Python packages and their dependencies. For macOS, you can also get the latest version of the EB CLI with Homebrew.

If you don't have Python and pip, use the procedure for your operating system. If you already have pip and a supported version of Python, use the following procedure to install the EB CLI.

To install the EB CLI

  1. Run the following command.

    $ pip install awsebcli --upgrade --user

    The --upgrade option tells pip to upgrade any requirements that are already installed. The --user option tells pip to install the program to a subdirectory of your user directory to avoid modifying libraries used by your operating sytem.


    If you encounter issues when you attempt to install the EB CLI with pip, you can install the EB CLI in a virtual environment to isolate the tool and its dependencies, or use a different version of Python than you normally do.

  2. Add the path to the executable file to your PATH variable:

    • On Linux and macOS:



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

      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 into your current session.

        $ source ~/PROFILE_SCRIPT
    • On Windows:

      Python 3.6%USERPROFILE%\AppData\Roaming\Python\Python36\Scripts

      Python 3.5%USERPROFILE%\AppData\Roaming\Python\Python3.5\Scripts

      Python previous versions%USERPROFILE%\AppData\Roaming\Python\Scripts

      To modify your PATH variable (Windows):

      1. Press the Windows key, and then type environment variables.

      2. Choose Edit environment variables for your account.

      3. Choose PATH, and then choose Edit.

      4. Add paths to the Variable value field, separated by semicolons. For example: C:\item1\path;C:\item2\path

      5. Choose OK twice to apply the new settings.

      6. Close any running command prompts and reopen command prompt.

  3. Verify that the EB CLI installed correctly by running eb --version.

    $ eb --version EB CLI 3.7.8 (Python 3.4.3)

The EB CLI is updated regularly to add functionality that supports the latest Elastic Beanstalk features. To update to the latest version of the EB CLI, run the installation command again.

$ pip install awsebcli --upgrade --user

If you need to uninstall the EB CLI, use pip uninstall.

$ pip uninstall awsebcli