
Deploy Kill Bill
Open-source subscription billing and payments, with the Kaui admin UI
Just deployed
/var/lib/mysql
Just deployed
/var/lib/killbill/data
Just deployed
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
- Kill Bill documentation
- Kill Bill releases and Kaui releases
- Template repository (Dockerfiles, start scripts, changelog)
Implementation Details
- Your apps call the API at the killbill service's URL with HTTP basic auth (
adminandKB_ADMIN_PASSWORD) plus the tenant headersX-Killbill-ApiKeyandX-Killbill-ApiSecret. Services in the same project can usehttp://${{killbill.RAILWAY_PRIVATE_DOMAIN}}:8080. /1.0/threadsand/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_SECRETafter 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
