SPICE Linked Data Hub (LDH) -- Docker release

This project includes the final packaged version of the SPICE Linked Data Hub (LDH), developed by the EU-funded project SPICE, including links to the resources required for setting up an instance of the LDH platform and instructions for deploying new LDH instances.

For ease of deployment, the LDH and its constituent components are made available here as a series of Docker containers. In what follows, we will cover the steps involved in downloading and running the Docker containers and how to access the resulting LDH services once they are up and running.

Installing and running the containers

Install Docker. If Docker is not already installed on your system, follow the instructions on the Docker website to install it.

Download the latest version of the SPICE LDH docker environment from its GitHub repository, at https://github.com/spice-h2020/spice-ldh-docker, using the command:

git clone https://github.com/spice-h2020/spice-ldh-docker.git

Within the repository directory, build the containers:

cd spice-ldh-docker docker compose build

Run the Docker containers:

docker compose up

Accessing the LDH services

Once the containers are running, the LDH services are available locally at the following URLs:

http://localhost:8091/ - LDH Portal. This is the main LDH web interface. On first install, an admin user is automatically created with the following credentials:

username: admin@example.com password: password

Once logged in, additional users can be created. You should start by creating your own administrator user account. Once logged in using this account, you can begin creating datasets and access keys.

http://localhost:8090/ - LDH API. Use of this web interface isn’t strictly required, although it is a useful tool for listing all API functions in a single place and providing an interface for testing API calls used in application development. Full documentation on the LDH and its web interface is covered in deliverable D6.8.

http://localhost:8099/ - LDH graph database (Blazegraph). This is not required for normal LDH use, but the graph database is visible at this address for debugging, inspection and SPARQL query testing purposes.

Stopping and starting the services

Once running, the Docker containers will be shown in the Docker desktop application as green. The entire SPICE LDH Docker environment can be started and stopped using the start and stop buttons shown in the top-right. On the first creation of the containers, blank datasets will be initialised for all the required LDH storage. After this, stopping and starting the containers will persist this storage so data is not lost. Note that deleting and rebuilding the containers will lose the existing data storage and initialise the LDH environment with a new fresh and empty data storage component once again.