[Updated] Having fun with Docker, Stripe and Kill Bill

by | Jul 25, 2016 | System Integration

Docker logo

Note! An updated version of this tutorial can be found here.

One of our most popular blog posts is Having fun with Docker, Stripe and Kill Bill, where we showed how easy it is to leverage the powerful subscription engine offered by Kill Bill while delegating payments to Stripe.

A lot has happened over the past 18 months: tools like docker-machine and docker-compose have become better and recent releases of Kill Bill have removed the need to edit various configuration files post-installation. Let’s take a look at how simple the installation process has become.

I assume you already have Docker installed and created a Stripe account.

The first step is to create a machine to run your containers. On a mac, you would typically use the virtualbox driver:

docker-machine create -d virtualbox killbill
eval $(docker-machine env killbill)

Note that to deploy Kill Bill to the cloud, the steps are similar (simply replace the driver with your provider’s, such as Microsoft Azure for example).

Next, create a docker-compose file similar to the one below:

and run:

docker-compose up

3 containers will start: one for MariaDB (shared database), one for Kill Bill itself and one for Kaui (Kill Bill admin UI). You can then explore Kill Bill APIs by going to or log-in to Kaui by going to (username: admin, password: password) to create your tenant. Note: make sure to replace with the IP of your machine which you can retrieve via

docker-machine ip killbill

The final step is to configure your Stripe credentials. Create a configuration file stripe.yml:

  :api_secret_key: 'sk_test_aaaabbbbccccdddd'

and upload it via Kaui at

Kaui Stripe configuration

That’s it! To test your installation, you can run our sample Sinatra app, which will show you how to:

  • Use Stripe.js to tokenize the card
  • Store the token in Kill Bill for subsequent (or recurring) payments
  • Create subscriptions, generate invoices and trigger automatic payments
  • Retrieve a Kill Bill payment in your Stripe dashboard

If you run in any integration issues, feel free to reach out to our Kill Bill Community!

Related Articles