This page provides a step by step guide on how to install an Ontopia distribution.

• Java 1.8 JDK or higher

It might still be possible to compile Ontopia under Java 7, but it is no longer supported. All deployed maven artifacts and the distribution will be compiled in Java 8. It is possible to start the Tomcat 9 bundled in the distribution with Java 11, higher versions have not yet been tested.

You can download the latest release distribution from the Ontopia GitHub releases page. Make sure you download the distribution and not the source code if you just want to use Ontopia.

• Unpack the distribution in a location of your choice. Avoid directories with spaces in the name, as those might stop Ontopia from starting correctly.
• All the documentation is in the doc directory, have a look at Installation and getting started under General documents for more details on installation options. The documentation is also available online.

Running the Ontopia distribution basically comes down to running a Tomcat container instance.

Locate the apache-tomcat/bin directory in Windows Explorer and double-click on the startup.bat file.

Change directory to apache-tomcat in a terminal and execute the bin/startup.sh script.