Self-contained Kaui application. It mounts the following engines:
- Kaui: the core administrative UI
- The Analytics UI (available when the Analytics plugin is installed)
- The KPM UI (available when the KPM plugin is installed)
- The AvaTax administrative module (available when the AvaTax plugin is installed)
Release builds are available on Maven Central with coordinates org.kill-bill.billing.kaui:kaui-standalone.
| Kaui version | Kill Bill version |
|---|---|
| 0.7.y | 0.16.z |
| 0.8.y | 0.18.z (Rails 4) |
| 0.9.y | 0.18.z (Rails 5, where z >= 13) |
| 1.x.y | 0.20.z (Rails 5) |
| 2.0.y | 0.22.z (Rails 5) |
| 2.1.y | 0.24.z (Rails 6) |
| 3.x.y | 0.24.z (Rails 7) |
This is a standard Rails project:
bundle install
rails s
When using your own database, make sure to install the DDL file from Kaui.
- Kill Bill client configuration can be found in config/initializers/killbill_client.rb
- Database configuration can be found in config/database.yml
Additionally, the project can be packaged as a self-contained war. Builds are available on Maven Central. Simply drop the war in your container of choice (e.g. Tomcat).
We also provide Docker images.
You need at least jruby-9.1.14.0.
To create a self-contained war:
bundle install && \
export RAILS_ENV=production && \
bundle exec rake assets:clobber assets:precompile && \
bundle exec warble
Alternatively, if you want to create a self-executable war:
bundle install && \
export RAILS_ENV=production && \
bundle exec rake assets:clobber assets:precompile && \
bundle exec warble executable war
You can then run it using:
java -Dkaui.db.adapter=mariadb \
-Dkaui.url=http://127.0.0.1:8080 \
-Dkaui.db.url=jdbc:mysql://localhost/kaui \
-Dkaui.db.username=killbill \
-Dkaui.db.password=killbill \
-Dwarbler.port=3000 \
-jar killbill-admin-ui-standalone.war
The startup process will be done when the following message appears:
2015-10-13 18:11:43.571:INFO:oejs.Server:main: Started @25244ms
The logs directory can be set via System Properties (e.g. -DLOGS_DIR=/var/log/tomcat7) or via a custom logback.xml (e.g. -Dlogback.configurationFile=/etc/killbill/logback.xml).