The documentation you're currently reading is for version 2.4.1. Click here to view documentation for the latest stable version.

System RequirementsΒΆ

BWC requires Ubuntu, RHEL or CentOS. The table below lists the supported Linux versions, along with Vagrant Boxes and Amazon AWS instances we use for testing. Yes, using exactly the same boxes will improve your experience.

Linux (64 bit) Vagrant Box Amazon AWS AMI
Ubuntu 14.04 bento/ubuntu-14.04 Ubuntu Server 14.04 LTS (HVM)
Ubuntu 16.04 bento/ubuntu-16.04 Ubuntu 16.04 LTS - Xenial (HVM)
RHEL 7 / CentOS 7 bento/centos-7.2 Red Hat Enterprise Linux (RHEL) 7.2 (HVM)
RHEL 6 / CentOS 6 bento/centos-6.7 Red Hat Enterprise Linux (RHEL) 6 (HVM)

Alternatively, you can use the BWC Docker image. You will need at least version 1.13.0 of Docker engine, and optionally docker-compose. See our Docker Image guide for more information.


Please note that only 64-bit architecture is supported.

While the system can operate with lower specs, these are the recommendations for the best experience while testing or deploying BWC:

Testing Production
  • Dual CPU system
  • 2GB RAM
  • 10GB storage
  • Recommended EC2: t2.medium
  • Quad core CPU system
  • >16GB RAM
  • 40GB storage
  • Recommended EC2: m4.xlarge

If you split your filesystem into multiple partitions and mount points, ensure you have at least 1GB of free space in /var and /opt. RabbitMQ and MongoDB may not operate correctly without sufficient free space.

By default, BWC and related services use these ports: nginx (80, 443), mongodb (27017), rabbitmq (4369, 5672, 25672), postgresql (5432) and st2 (9100-9102). If any other services are currently using these ports, BWC may fail to install or run correctly.