Public | Automated Build

Last pushed: 2 years ago
Short Description
Annotation Backend
Full Description


Catching Annotation (Catch-A)

This software was created for the Harvard Library Labs project CATCH ( awarded to Phil Desenne, Martin Schreiner and Paolo Ciccarese

The software was originally written by:

You can find the core plugin dependencies at

Getting Started

Developer Installation

Install dependencies

Install GVM


$ curl -s | bash

Install Grails

After downloading the source code check catcha/Catch/ to find the required Grails version.


To install the appropriate grails version:

$ gvm install grails 2.2.1


See On Ubuntu

sudo apt-get install mysql-server

Build application from source

Download application source code

$ git clone

Download plugin source code

There are several plugins that are included as "local plugin" dependencies within the application's BuildConfig.groovy. It's important that the root directory of these plugins (annotationframework) is located at the same level as the catcha directory.

$ mkdir annotationframework
$ cd annotationframework
$ git clone
$ git clone
$ git clone
Create database
mysql -u root -p -e 'create database catch default charset utf8;'
Create database user
mysql -u root -p -e 'grant all on catch.* to "catch"@"localhost" identified by "<password>";'
Create external configuration file

If you changed the database name, username, or password you need to edit an external configuration file.

NOTE: I needed to rename the file (lowercase 'c') in order to get the application to read this file.

$ cd Catch
$ mv

Add the following properties to catcha/Catch/

# Database connection settings

NOTE: Do NOT change the database name as there is a bug I just discovered in the Liquibase changesets that hard-codes the schema name to "catch" when dealing with foreign key contstraints.

Run application in development mode

$ grails run-app

Develop with Docker

When developing with Docker, all the dependencies are included in docker images. No need to install anything on the host other than (docker)[]

NOTE: This repo has submodules. If --recursive is not specified when cloning the repo, you need to run git submodule update --init to pull down the submodules.

Update configruation

Update the following line in




Start application

docker-compose up -d

Docker will download official MySQL image and build catcha image. Docker-compose will create a docker network and run both images. Once they are started, the application can be accessed at http://localhost:8080.

Once the docker containers are running, you can make changes to the files on the host and they will be auto-reloaded.

Check logs

docker logs -f catch_app_1

Stop application

docker-compose stop

Tear down application

docker-compose down
Docker Pull Command
Source Repository