Getting Ansible Container


Then simply:

$ sudo pip install ansible-container

If you do not have root privileges, you’ll need to use a virtualenv to create a Python sandbox:

$ virtualenv ansible-container
$ source ansible-container/bin/activate
$ pip install ansible-container

You’ll need to run the activate script in each shell session prior to invoking ansible-container. See the virtualenv docs for details.

Running from Source

If you’d like to run the bleeding edge version of Ansible Container, you can obtain it from our Github repository.


Clone the repo:

$ git clone

We recommend that you use a Python Virtualenv to sandbox your installation. See the virtualenv docs for instructions.

If you just want to run ansible-container:

$ cd ansible-container
$ python ./ install

Or, if you plan to help develop ansible-container:

$ cd ansible-container
$ python ./ develop

If you run into the following error, you likely have an older version of setuptools installed:

Traceback (most recent call last):
  File "./", line 11, in <module>
  TypeError: find_packages() got an unexpected keyword argument 'include'

Use the following to upgrade to the latest release, and then run the install command again:

$ pip install --upgrade setuptools

You may need to run the above command with sudo if you’re not using a virtualenv.