---
title: "Deploy Kill Bill"
description: "Open-source subscription billing and payments, with the Kaui admin UI"
category: "Other"
url: https://railway.com/deploy/kill-bill-1
---

# Deploy Kill Bill

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

**[Deploy Kill Bill on Railway](https://railway.com/template/kill-bill-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/kill-bill-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### mariadb https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mariadb.png

- **Source:** https://github.com/aalfath/killbill-railway-template

### killbill https://killbill.io/images/webclip.png

- **Source:** https://github.com/aalfath/killbill-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

### kaui https://killbill.io/images/webclip.png

- **Source:** https://github.com/aalfath/killbill-railway-template
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# 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](https://docs.killbill.io/latest/)
* [Kill Bill releases](https://github.com/killbill/killbill/releases) and [Kaui releases](https://github.com/killbill/killbill-admin-ui/releases)
* [Template repository](https://github.com/aalfath/killbill-railway-template) (Dockerfiles, start scripts, changelog)

### 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/kill-bill-1
