Kill Bill Administration UI
Ruby HTML Shell JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
pierre Gemfile: switch to master branch
Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>
Latest commit 24d3e62 Jul 10, 2018

README.md

kaui-standalone

Self-contained Kaui application. It mounts the following engines:

Release builds are available on Maven Central with coordinates org.kill-bill.billing.kaui:kaui-standalone.

Kill Bill compatibility

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.19.z

Run

This is a standard Rails project:

bundle install
rails s

When using your own database, make sure to install the DDL file from Kaui.

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.

Build

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