Deploy Kill Bill

Open-source subscription billing and payments, with the Kaui admin UI

Deploy Kill Bill

/var/lib/mysql

/var/lib/killbill/data

Deploy and Host Kill Bill on Railway

Kill Bill is an open-source subscription billing and payments platform (Apache 2.0). It manages product catalogs, subscriptions with trials, upgrades and add-ons, usage billing, invoices, payments through gateway plugins such as Stripe and Adyen, and dunning. Kaui, its admin UI, lets your team manage tenants, accounts, catalogs, invoices and payments from the browser.

About Hosting Kill Bill

This template deploys three services built from one public GitHub repo. killbill runs the Kill Bill 0.24.22 REST API on a public URL, with a /healthz health check and its plugins on a volume. kaui runs the Kaui 4.0.31 admin UI on a public URL. mariadb runs Kill Bill's MariaDB image with both schemas, on a volume, private network only. The admin password, database passwords and Kaui keys are generated at deploy time, and the image's default password is refused. After deploy, open the kaui URL, sign in as admin with KB_ADMIN_PASSWORD (killbill service variables), create a tenant and upload a catalog.

Common Use Cases

  • Recurring subscription billing for a SaaS product, with plans, trials, upgrades, downgrades and proration
  • Usage-based and hybrid billing with invoices, credits and dunning that you host yourself
  • One billing and payments layer in front of several gateways (Stripe, Adyen, PayPal, Braintree) through Kill Bill plugins

Dependencies for Kill Bill Hosting

  • MariaDB with the Kill Bill and Kaui schemas (included, on a Railway volume)
  • Kill Bill server and Kaui admin UI (both included)

Deployment Dependencies

Implementation Details

  • Your apps call the API at the killbill service's URL with HTTP basic auth (admin and KB_ADMIN_PASSWORD) plus the tenant headers X-Killbill-ApiKey and X-Killbill-ApiSecret. Services in the same project can use http://${{killbill.RAILWAY_PRIVATE_DOMAIN}}:8080.
  • /1.0/threads and /1.0/metrics, which upstream serves without login, are refused. JVM debug and JMX ports listen only on loopback.
  • Images are pinned by version and digest. When we bump a version in the repo, Railway shows an "update available" notice on your project and you choose when to apply it. Kill Bill runs its database migrations on start. Read the repo's CHANGELOG.md first and back up the mariadb volume.
  • Do not change KAUI_ENCRYPTION_SECRET after the first deploy: Kaui uses it to decrypt the tenant secrets it stores.

Why Deploy Kill Bill on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Kill Bill on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0