Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This repository is no longer maintained. The functionality provided here has been put into individual repositories such as:


The Niord web application runs in a JBoss Wildfly server and require MySQL and JBoss Keycloak to function.

The scripts of this project folder will install and configure a development server system running at localhost, and Keycloak will be deployed as an overlay to the Wildfly server.


  • Java 8
  • Maven 3
  • MySQL 5.7.10+ (NB: proper spatial support is a requirement)


Currently, the installation scripts are for Bash, i.e. unix-platforms. Feel free to contribute Windows scripts ;-)

MySQL Configuration

Two databases are needed, one for Keycloak and one for the Niord web application.

mysql -u root -p < 01-mysql/create-keycloak-db.sql
mysql -u root -p < 01-mysql/create-niord-db.sql

Wildfly Installation and Configuration

Installs a Wildfly server and configures a MySQL data source, a Hibernate Spatial module and a Keycloak adapter.


Keycloak Installation and Configuration

Installs the Keycloak server and configures a MySQL data source, configures HTTPS, etc.


Add a Keycloak admin user using the command

./keycloak-folder/bin/ -r master -u <<user>> -p <<password>>

Importing a Keycloak Realm

Once Keycloak has been installed, you can start it up with a Niord bootstrap realm. Run the following command:


The imported realm, as defined in niord-bootstrap-realm.json, will create a "Master" Niord domain along with a system administrator user (sysadmin/sysadmin) that can be used to configure the Niord system.

Use the sysadmin user to create new domains, possibly by importing a Niord base data set, as described in the next section.

Importing Niord Base Data

Once you have deployed the Niord web application, you can populate the database with a set of base data, including areas, charts, categories, domains, etc.

Copy the archive to the $NIORD_HOME/batch-jobs/batch-sets/ folder.

Running behind a reverse SSL proxy

If you run Niord behind an Apache Web Server, say via docker on port 8081, add a VirtualHost along the lines of:

<VirtualHost *:443>
    SSLEngine On
    SSLCertificateFile /path/to/ssl-cert.crt
    SSLCertificateKeyFile /path/to/ssl-cert.key
    SSLCACertificateFile /path/to/ssl-cert.crt
    ProxyPass           /robots.txt !
    ProxyPass           /  http://localhost:8081/
    ProxyPassReverse    /  http://localhost:8081/
    ProxyRequests Off
    ProxyPreserveHost On
    RequestHeader set originalScheme "https"
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-Port "443"


Niord application server set-up




No releases published


No packages published