Setup LinkedDataHub on your local machine or access it in the cloud.

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, see the system base URI configuration.

  1. Install Docker
  2. Fork the LinkedDataHub repository and clone the fork into a folder
  3. 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
    OWNER_KEY_PASSWORD=changeit
  4. Run this from command line:
    docker-compose up
  5. LinkedDataHub will start and create the following sub-folders:
    1. certs where your WebID certificates are stored
    2. data where the triplestore(s) will persist RDF data
    3. 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_KEY_PASSWORD value.

After a successful startup, the last line of the Docker log should read:

linkeddatahub_1    | 02-Feb-2020 02:02:20.200 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 3420 ms

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 certs data && docker-compose down -v

This will remove the persisted data, server and owner certificates as well as their Docker volumes.

Is LinkedDataHub running? Proceed to get an account.

Access LinkedDataHub Cloud

Go to LinkedDataHub Cloud, which is a managed LinkedDataHub service with multiple application support.

Date Created
17 March 2020 20:44
Maker
Martynas Jusevičius
Owner
Martynas Jusevičius