Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
An open-source subscription billing and payments platform, in production since 2010. It handles catalogs and pricing, subscriptions, usage metering, invoicing, payments across gateways, credits, tax and dunning, and is modular: payment gateways, tax engines and other features come as plugins. It is a Java server with a REST API; Kaui, a separate web admin UI, manages accounts, subscriptions, invoices and payments. The Docker setup runs Kill Bill, Kaui and a MariaDB database prepared with their schemas.
Runs on a VPS from $24/mo (Kamatera 8GB, 8 GB RAM) · prices checked Nov 2026
Fits home hardware (1,833 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick Kill Bill when you need a billing engine for recurring subscriptions that you control: a catalog of plans and prices, trials and phases, usage-based items, invoice generation, credits, tax, dunning and payments routed through gateway plugins, driven through a REST API with Kaui as the admin interface. It is Java, licensed Apache-2.0 (Kaui is MIT), has been in production since 2010, and the README says it is deliberately not an all-in-one product, so you disable what you do not need and plug in the rest. Our snippet follows the project's docker-compose recipe and getting-started guide with `killbill/killbill:0.24.22` and `killbill/kaui:4.0.31` (both pushed to Docker Hub 2026-09-29) and the `killbill/mariadb:0.24` image pinned by digest, because that tag is rebuilt in place (pushed 2026-09-29, the same day as the Kill Bill 0.24.22 image); it generates the database password into `.env` and does not publish the database. The getting-started guide says to have at least 4 GiB of RAM on Ubuntu, which is our floor. In the catalog, Lago is the usage-metering alternative with a Rails API and a React app; Invoice Ninja, InvoiceShelf and SolidInvoice are invoicing applications for sending invoices to clients, with recurring invoices and, in Invoice Ninja and SolidInvoice, online gateway payments; they are not API-first billing engines with catalogs and plugins. Kill Bill suits a team that will write code against the API and is comfortable operating a Java service.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Kill Bill — subscription billing and payments platform, with Kaui as its admin UI — adapted from the project's docker-compose recipe, Kill Bill 0.24.22 and Kaui 4.0.31 on MariaDB
echo "DB_PASSWORD=$(openssl rand -hex 16)" > .env
cat > docker-compose.yml <<'EOF'
services:
db:
image: killbill/mariadb:0.24@sha256:8fddf7d564befcea3e3d762c01b3e65fb4b45fb8db077297998ad935468372fa
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
healthcheck:
test: ["CMD-SHELL", "mariadb -h127.0.0.1 -uroot -p$$MYSQL_ROOT_PASSWORD -e 'SELECT 1 FROM kaui.kaui_allowed_users LIMIT 1'"]
interval: 5s
timeout: 5s
retries: 40
volumes:
- db_data:/var/lib/mysql
killbill:
image: killbill/killbill:0.24.22
restart: unless-stopped
depends_on:
db:
condition: service_healthy
ports:
- 8080:8080
environment:
KILLBILL_DAO_URL: jdbc:mysql://db:3306/killbill
KILLBILL_DAO_USER: root
KILLBILL_DAO_PASSWORD: ${DB_PASSWORD}
KILLBILL_METRICS_INFLUXDB: "false"
kaui:
image: killbill/kaui:4.0.31
restart: unless-stopped
depends_on:
db:
condition: service_healthy
ports:
- 9090:8080
environment:
KAUI_CONFIG_DAO_URL: jdbc:mysql://db:3306/kaui
KAUI_CONFIG_DAO_USER: root
KAUI_CONFIG_DAO_PASSWORD: ${DB_PASSWORD}
KAUI_KILLBILL_URL: http://killbill:8080
volumes:
db_data:
EOF
docker compose up -d
timeout 600 bash -c 'until curl -fsS -o /dev/null http://localhost:8080/1.0/healthcheck; do sleep 5; done'
timeout 300 bash -c 'until curl -fsSL -o /dev/null http://localhost:9090/; do sleep 3; done'
# → http://SERVER_IP:9090 — the Kaui login; sign in as admin / password (change it with KB_ADMIN_PASSWORD or shiro.ini; the same credential opens the API on 8080), then create a tenant to start. The Kill Bill API is on port 8080Kill Bill's documentation and Docker recipe flag these before you rely on it:
Kill Bill used 1833 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 4096 MB.
The Kill Bill install snippet is marked verified on Ubuntu 26.04 (Nov 2026).