a ; ; "2026-06-16T20:33:27.893Z"^^; ; "Step by step guide to installing and uninstalling packages"; "Manage packages"; ; . a ; "
\n

Step by step guide to installing and uninstalling packages in your LinkedDataHub dataspace.

\n
\n

Version: Packages were introduced in LinkedDataHub 5.2.

\n
\n
\n

Package management requires Control access to the administration application. Only users with administrative privileges can install or uninstall packages.

\n
\n

Read more about how packages work.

\n
\n

Important: After installing or uninstalling a package, you must restart the Docker service for XSLT stylesheet changes to take effect:

\n 
docker-compose restart linkeddatahub
\n

Do not use --force-recreate as that would overwrite the stylesheet file changes.

\n
\n
\n

Install a package

\n

Installing a package adds new functionality to your dataspace by importing ontologies, data, and resources.

\n
\n \n
\n
\n

Follow these steps to install a package through the web interface:

\n
    \n
  1. Open the package URI in browser mode by entering its URI in the address bar
    2. \n
  2. Click the Actions dropdown button next to the package
    3. \n
  3. Select Install from the dropdown menu
    4. \n
  4. Wait for the installation to complete
    5. \n
  5. Refresh your browser to ensure the new package functionality is loaded
    6. \n
\n
\n
\n

Execute the following command:

\n 
install-package.sh \\\n  -b \"https://localhost:4443/\" \\\n  -f ssl/owner/cert.pem \\\n  -p \"$owner_cert_password\" \\\n  --package \"https://packages.linkeddatahub.com/skos/#this\"
\n

Parameters:

\n
\n
-b
\n
Base URL of your LinkedDataHub instance
\n
-f
\n
Path to your owner certificate file
\n
-p
\n
Owner certificate password
\n
--package
\n
Package URI to install (e.g., https://packages.linkeddatahub.com/skos/#this)
\n
\n
\n
\n
\n
\n
\n

Uninstall a package

\n

Uninstalling a package removes its ontologies and resources from your dataspace. User-created data that uses the package vocabulary will remain but may not function correctly.

\n
\n \n
\n
\n

Follow these steps to uninstall a package through the web interface:

\n
    \n
  1. Navigate to the administration application of your dataspace
    2. \n
  2. Open the Packages container to view installed packages
    3. \n
  3. Find the package you want to uninstall in the list
    4. \n
  4. Click the Actions dropdown button next to the package
    5. \n
  5. Select Uninstall from the dropdown menu
    6. \n
  6. Confirm the uninstallation when prompted
    7. \n
  7. Wait for the uninstallation to complete
    8. \n
\n

Uninstalling a package will remove its ontologies and associated resources. Any data you created using the package's vocabulary will remain in your dataspace but may not display or function correctly without the package.

\n
\n
\n

Execute the following command:

\n 
uninstall-package.sh \\\n  -b \"https://localhost:4443/\" \\\n  -f ssl/owner/cert.pem \\\n  -p \"$owner_cert_password\" \\\n  --package \"https://packages.linkeddatahub.com/skos/#this\"
\n

Parameters are the same as for installation.

\n
\n
\n
\n
\n
\n

Verify package installation

\n

After installing a package, verify that it was installed correctly:

\n
    \n
  1. Navigate to the administration application
    2. \n
  2. Click on Ontologies in the left navigation menu
    3. \n
  3. Verify that the package ontology appears in the list of imported ontologies
    4. \n
  4. In the end-user application, check that package-specific classes and properties are available when creating new resources
    5. \n
  5. If the package includes stylesheets, verify that custom UI elements are rendering correctly
    6. \n
\n
\n
\n

Customize package behavior

\n

Packages may include custom XSLT stylesheets that affect how data is displayed. You can further customize the behavior by:

\n \n

See the Change layout guide for detailed instructions on stylesheet customization.

\n
\n
\n

Troubleshooting

\n

Installation fails

\n

If package installation fails:

\n
    \n
  • Verify you have Control access to the administration application
    • \n
  • Check that all package dependencies are met
    • \n
  • Review the error message for specific issues
    • \n
  • Ensure the package files are valid and well-formed
    • \n
\n

Package functionality not visible

\n

If installed package features are not visible:

\n
    \n
  • Refresh your browser to reload the application
    • \n
  • Clear the browser cache if stylesheets are not updating
    • \n
  • Verify the package ontology is imported in the Ontologies section
    • \n
  • Check that you have appropriate permissions to view package resources
    • \n
\n
\n
"^^ .