Kill Bill on Microsoft Azure

by | Jul 3, 2016 | System Integration

Kill Bill on Microsoft Azure

The open-source Kill Bill platform provides advanced subscription management as well as payment APIs. Businesses of any size, from the 2-person startup to public companies, rely on it for their e-commerce recurring billing and shopping cart payment needs.

Lots of SaaS companies have similar offerings. Choosing the right partner from the get go is critical however, as migrations are error-prone and difficult. If you are a young startup, you probably want something simple, cheap and low-maintenance, which can adapt to your needs as you grow. Kill Bill combined with Microsoft Azure BizSpark for startups gives you just that, which probably explains the uptick of requests we’ve had recently regarding integration with Microsoft Azure.

Thanks to our Docker images, this is quite easy – this tutorial will show you how to deploy Kill Bill integrated with Stripe in a few commands.


VM setup

Create the VM using docker-machine:

docker-machine create -d azure \
                      --azure-ssh-user ops \
                      --azure-subscription-id AZURE_SUBSCRIPTION_ID \
                      --azure-open-port 8080 \
                      --azure-open-port 3000 \

You should see it running at

Write down the IP of the machine by running docker-machine ip azure

Configure your shell for the rest of the tutorial:

eval $(docker-machine env azure)

Database setup

For this tutorial, we will simply run a MySQL database in a Docker container on the same host:

docker run -tid \
           --name db \
           -p 3306:3306 \
           -e MYSQL_ROOT_PASSWORD=root \
           -e MYSQL_DATABASE=killbill \

Modify the database to make sure it is using the ROW binlog_format:

echo "set global binlog_format = 'ROW'" | docker exec -i db mysql -h localhost -uroot -proot

To install the tables required by Kill Bill itself, run:

curl -s | docker exec -i db mysql -h localhost -uroot -proot -D killbill

To install the tables required by the Stripe plugin, run:

curl -s | docker exec -i db mysql -h localhost -uroot -proot -D killbill

You can verify the 49 tables were correctly installed by running:

echo 'show tables' | docker exec -i db mysql -h localhost -uroot -proot -D killbill

Kill Bill setup

Create the Docker container which will run Kill Bill with the Stripe plugin, connected to the MySQL container:

docker run -tid \
           --name killbill \
           -p 8080:8080 \
           --link db:dbserver \
           -e KILLBILL_CONFIG_DAO_URL=jdbc:mysql://dbserver:3306/killbill \
           -e KILLBILL_CONFIG_DAO_USER=root \
           -e KILLBILL_CONFIG_OSGI_DAO_URL=jdbc:mysql://dbserver:3306/killbill \
           -e KILLBILL_CONFIG_OSGI_DAO_USER=root \
           -e KILLBILL_PLUGIN_STRIPE=1 \

Check the Kill Bill logs to verify it was started correctly:

docker logs -tf killbill

Kaui setup (optional)

While Kill Bill is now ready to be used, we recommend installing Kaui as well, the Kill Bill Admin UI.

Kaui needs its own database and set of tables. We will also create an initial admin user:

echo "create database kaui" | docker exec -i db mysql -h localhost -uroot -proot

curl -s | docker exec -i db mysql -h localhost -uroot -proot -D kaui

echo "insert into kaui_allowed_users (kb_username, description, created_at, updated_at) values ('admin', 'super admin', NOW(), NOW());" | docker exec -i db mysql -h localhost -uroot -proot -D kaui

Start the Kaui container:

docker run -tid \
           --name kaui \
           -p 3000:8080 \
           --link db:dbserver \
           --link killbill:killbill \
           -e KAUI_URL=http://killbill:8080 \
           -e KAUI_API_KEY= \
           -e KAUI_API_SECRET= \
           -e KAUI_CONFIG_DAO_URL=jdbc:mysql://dbserver:3306/kaui \
           -e KAUI_CONFIG_DAO_USER=root \
           -e KAUI_CONFIG_DAO_PASSWORD=root \

Check the Kaui logs to verify it was started correctly:

docker logs -tf kaui


Kill Bill is available at VM_IP:8080 and Kaui at http://VM_IP:3000. Log-in to Kaui using the admin/password credentials and create your test tenant. You should now be able to create accounts, subscriptions, etc.

Our Getting started guide will guide you in exploring Kaui. Our subscription and payment guides will go over how to configure and integrate Kill Bill with your application. Make sure also to configure your Stripe credentials to start triggering payments.

Questions about next steps? Feel free to reach-out to our mailing-list for help!

Related Articles