Setup

Start LinkedDataHub

This section assumes you will be running on your local machine, i.e. localhost. If you intend to run it on a different host, change the system base URI.

Prerequisites:

• bash shell. It should be included by default on Linux. On Windows you can install the Windows Subsystem for Linux.
• openssl available on $PATH.
• Docker installed
• Docker Compose installed

Steps:

1. Fork the LinkedDataHub repository and clone the fork into a folder
2. In the folder, create an .env file and fill out the missing values (you can use .env_sample as a template). For example:

   COMPOSE_CONVERT_WINDOWS_PATHS=1
   COMPOSE_PROJECT_NAME=linkeddatahub
   
   PROTOCOL=https
   HTTP_PORT=81
   HTTPS_PORT=4443
   HOST=localhost
   ABS_PATH=/
   
   OWNER_MBOX=john@doe.com
   OWNER_GIVEN_NAME=John
   OWNER_FAMILY_NAME=Doe
   OWNER_ORG_UNIT=My unit
   OWNER_ORGANIZATION=My org
   OWNER_LOCALITY=Copenhagen
   OWNER_STATE_OR_PROVINCE=Denmark
   OWNER_COUNTRY_NAME=DK

3. Setup the server's SSL certificates by running this from command line:

   ./bin/server-cert-gen.sh .env nginx ssl

   The script will create an ssl/server sub-folder where the SSL certificate will be stored.
4. Run this from command line:

   docker-compose up --build

   LinkedDataHub will start and mount the following sub-folders:
   1. data where the backend triplestores will persist RDF data
   2. datasets where the owner and secretary agent metadata is persisted
   3. ssl/owner and ssl/secretary where the owner and secretary SSL certificates and WebID public keys are persisted
   4. uploads where LinkedDataHub stores content-hashed file uploads

You are now the owner of this LinkedDataHub instance; certs/owner.p12 is your WebID certificate. Password is the owner_cert_password secret value.

After a successful startup you should see periodic healtcheck requests being made to the https://localhost:4443/ns URL.

Reset

If you need to start fresh and wipe the existing setup (e.g. after configuring a new base URI), you can do that using:

sudo rm -rf data datasets uploads ssl && docker-compose down -v