Skip to content
Matthew Maurer edited this page Feb 9, 2015 · 2 revisions

What is this?

Some people have difficulty installing BAP, just want to try it out quickly, or for whatever reason like containerized dev environments. This page is meant to assist them by explaining how to install BAP via Docker, which will skip most of the difficulty of dealing with dependencies/compilation.

If you already know what you're doing, the you're looking for maurer/bap:git or maurer/bap:latest. Otherwise, read on...

Docker

Docker is a container solution (think lightweight VM) for Linux, but is available for Windows and Mac via actual virtualization.

Linux

Install via your package manager if possible (this should be available on most distros). Otherwise, you can use the pieces of a docker install from here. Beware, this is potentially complex.

OS X

Grab the OS X Installer. This should go smoothly, the three people I've tested with have all had success.

Windows

Grab the Windows Installer. I have no experience with this version of docker, but I have no reason to believe it will not work.

BAP Containers

Docker containers with git or latest bap are available via Dockerhub. maurer/bap:git should contain the latest Git master, and maurer/bap:latest the latest release. For the moment these are the same, but they may diverge in the future.

Once you have docker installed, you should be able to run

docker pull maurer/bap:latest
docker run -ti maurer/bap:latest

in order to enter the environment with BAP installed.

For further information on how to use docker containers (such as how to persist your environment) see the Docker Documentation.

Building

If for some reason you want to build locally, you can use the Dockerfiles located from my repository.

You shouldn't need to do this, as I've instructed Dockerhub to automatically build off the repo and store the results for you.

Bugs

If you believe you have encountered an issue with the containers (not with docker, not with BAP), please file an issue here, or better yet file a pull request.

Please don't be upset if your issue isn't examined or fixed quickly, this is a side convenience repository and will only be serviced in an as-I-feel-like basis.

Clone this wiki locally