Public | Automated Build

Last pushed: 2 years ago
Short Description
Latest Kuali Coeus WAR file running in Tomcat on Ubuntu 16.04 LTS
Full Description

Kuali Coeus Tomcat Dockerfile

This repository contains the Dockerfile of an automated build of a Kuali Coeus Application/Tomcat image published to the public Docker Hub Registry.

How to Use the Kuali Coeus Application/Tomcat Images

Start a Kuali Coeus Application/Tomcat Instance

To use this image, you need a MySQL Kuali Coeus Database running, such as jefferyb/kuali_db_mysql

docker run  -d --name kuali-coeus-database -p 3306:3306 jefferyb/kuali_db_mysql

and then start a Kuali Coeus Application/Tomcat instance as follows:

docker run  -d \
            --name kuali-coeus-application \
            -e KUALI_APP_URL=EXAMPLE.COM \
            -e KUALI_APP_URL_PORT=8080 \
            -e MYSQL_HOSTNAME=kuali-coeus-database \
            --link kuali-coeus-database \
            -p 8080:8080 \

NOTE: This image needs at least 3 environment set:

  • -e KUALI_APP_URL=EXAMPLE.COM Where EXAMPLE.COM is the fqdn or IP address where you want to access it
  • -e KUALI_APP_URL_PORT=8080 The external port set using -p
  • -e MYSQL_HOSTNAME=kuali-coeus-database The MySQL hostname. If you're linking dockers, then it will the container name of your database

Build a Kuali Coeus Application/Tomcat Image yourself

You can build an image from the docker-compose.yml file:

docker-compose build

Alternatively, you can build an image from the Dockerfile:

docker build  -t jefferyb/kuali_tomcat

Watch the logs

You can check the logs using:

docker logs -f kuali-coeus-application

Access Kuali Coeus Application

To access the Kuali Coeus instance, go to:


Where EXAMPLE.COM is what you set at -e KUALI_APP_URL

Download the XML Files to ingest

To download the Kuali Coeus XML files, go to:

For rice-xml

For coeus-xml

Where ${Kuali-Coeus-Version} is the version number on the http://EXAMPLE.COM:8080/kc-dev login page.

For example:
if the current version on the login page says: KualiCo 1606 MySQL
then to get the rice-xml and coeus-xml files, the links would be:


Container Shell Access

The docker exec command allows you to run commands inside a Docker container. The following command line will give you a bash shell inside your Kuali Coeus Application/Tomcat container:

docker exec -it kuali-coeus-application bash

Environment Variables

When you start/build the Kuali Coeus Application/Tomcat image, you can adjust the configuration of the Kuali Coeus Application/Tomcat instance by passing one or more environment variables on the docker run command line or Dockerfile/docker-compose.yml file.

Most of the variables listed below are optional, but at least KUALI_APP_URL, KUALI_APP_URL_PORT, MYSQL_HOSTNAME need to be there to get started...


The fqdn or IP address where you want to access your application
Default: KUALI_APP_URL="localhost"


The port number where you want to access your application
Default: KUALI_APP_URL_PORT="8080"


The hostname of your MySQL instance. If you're linking dockers, then it will the container name of your database
Default: MYSQL_HOSTNAME="kuali-coeus-database"


The MySQL port number
Default: MYSQL_PORT="3306"


The username to use.
Default: MYSQL_USER="kcusername"


The password for the username.
Default: MYSQL_PASSWORD="kcpassword"


The name of the database.
Default: MYSQL_DATABASE="kualicoeusdb"

Docker Pull Command