Skip to content


This page gives an overview of the Lookup service, describing its current status, where and how it's developed and deployed, and who is responsible for maintaining it.

Service Description

Lookup provides an directory of University staff, institutions and groups available via LDAP (Uni only) or a web API.

Service Status

Lookup is currently live.


Technical queries and support should be directed to and will be picked up by a member of the team working on the service. To ensure that you receive a response, always direct requests to rather than reaching out to team members directly.

Queries regarding correctness or completeness of data should be sent to

Issues discovered in the service or new feature requests should be opened as GitLab issues here.


Lookup is currently deployed to the following environments:

Name URL Supporting VMs
ldap{1,2} (HA LDAP endpoints) (live LDAP endpoint)
Staging (test LDAP endpoint)

Source code

The source code for Lookup is spread over the following repositories:

Repository Description
Application Server The source code for the main application server
Lookup API Client API Client

Technologies used

The following gives an overview of the technologies Lookup is built on.

Category Language Framework(s)
Server Java + Groovy Grails 1.3.10
DB Postgres 12.4

Operational documentation

The following gives an overview of how Lookup is deployed and maintained.

How and where Lookup is deployed

Deployed using RPM packages from the Bes RPM repository.

A video recording of a deployment is available (DevOps only).

Deploying a new release

RPM packages are built by gitlab CI.

Other documentation


Lookup is monitored by nagios:


The Lookup server readme contains details on running a local copy for debugging.

Service Management and tech lead

The service owner for Lookup is currently unknown. See the associated GitLab issue.

The service manager for Lookup is Currently vacant.

The tech lead for Lookup is Monty Dawson.

The following engineers have operational experience with Lookup and are able to respond to support requests or incidents: