\n

Start LinkedDataHub

\n

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.

\n

Prerequisites:

\n

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

\n

Steps:

\n

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

   COMPOSE_CONVERT_WINDOWS_PATHS=1\nCOMPOSE_PROJECT_NAME=linkeddatahub\n\nPROTOCOL=https\nHTTP_PORT=81\nHTTPS_PORT=4443\nHOST=localhost\nABS_PATH=/\n\nOWNER_MBOX=john@doe.com\nOWNER_GIVEN_NAME=John\nOWNER_FAMILY_NAME=Doe\nOWNER_ORG_UNIT=My unit\nOWNER_ORGANIZATION=My org\nOWNER_LOCALITY=Copenhagen\nOWNER_STATE_OR_PROVINCE=Denmark\nOWNER_COUNTRY_NAME=DK

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

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

   \n The script will create an ssl/server sub-folder where the SSL certificate will be stored.\n
\n
4. Create the following secrets with certificate/truststore passwords:\n
   \n
   • secrets/client_truststore_password.txt
   \n
   • secrets/owner_cert_password.txt
   \n
   • secrets/secretary_cert_password.txt
   \n
   \n The one you will need to remember in order to authenticate with LinkedDataHub using WebID client certificate is owner_cert_password.\n
\n
5. (Optional) If you need to configure Bearer token authentication for SPARQL services, create secrets/credentials.trig with your service credentials. See the configuration reference for details.
\n
6. Run this from command line:\n

   docker-compose up --build

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

\n

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

\n

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

\n

\n

Reset

\n

If you need to start fresh and wipe the existing setup, you can do that using:

\n

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

\n \n