Skip to content

Install INCEpTION

Piotr Banski edited this page Jun 11, 2026 · 6 revisions

The windows section is going to consist of guesses, unless Beata decides to share.

General

https://inception-project.github.io/releases/40.6/docs/user-guide.html#sect_installation

We're (re)starting at version 40.6.

Downloads

https://inception-project.github.io/downloads/ -- with basic instructions.

Prerequisites

Note that this version assumes that you have at least Java 11. (In an updated system, that should not be a big issue -- my ancient Linux system has openjdk 17.0.9 2023-10-17 on it, the Adoptium site has Java 25 prepared for download; Java 11 is also there, should one wish to get exactly that one.)

Windows

Java

Adoptium link (that should switch to the Windoze section automagically if you access the main page, but): https://adoptium.net/temurin/releases , you may want to choose the .msi installer for JDK.

There is also a way to install stuff via winget, which is probably there in your newest Windows. The relevant command for Java 25 is: winget install EclipseAdoptium.Temurin.25.JDK

Install

Download the jar file (link above) and run it by double-clicking -- it will hopefully start, or we have a problem.

Linux

Java

What I could do is apt-get install temurin-25-jdk, but I'm going to stay with Java 17 for now, since:

$ sudo update-alternatives --list java
/usr/lib/jvm/java-11-openjdk-amd64/bin/java
/usr/lib/jvm/java-17-openjdk-amd64/bin/java
/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java

Start it

$ java -jar inception-app-webapp-40.6-standalone.jar 
Error: LinkageError occurred while loading main class de.tudarmstadt.ukp.inception.bootloader.ExtensibleClasspathEnabledWarLauncher
        java.lang.UnsupportedClassVersionError: de/tudarmstadt/ukp/inception/bootloader/ExtensibleClasspathEnabledWarLauncher has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0

... which means that I do need that new Java, or a recompilation of the old one. So the new one it is. (The problem lies with the installation instructions -- they are outdated. I've just e-mailed the maintainer.)

What I had to do on my old, old desktop is:

  • sudo apt install -y wget apt-transport-https gpg -- just to check
  • wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /usr/share/keyrings/adoptium.gpg > /dev/null
  • echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb noble main" | sudo tee /etc/apt/sources.list.d/adoptium.list (to pretend I'm something I'm not)
  • sudo apt update
  • sudo apt install -y temurin-25-jdk (great success!)
$ sudo update-alternatives --display java
java - auto mode
  link best version is /usr/lib/jvm/temurin-25-jdk-amd64/bin/java
  link currently points to /usr/lib/jvm/temurin-25-jdk-amd64/bin/java
  link java is /usr/bin/java
...

Amazinnng...

$ java -jar inception-app-webapp-40.6-standalone.jar 

  _____    __  ___   __     __________  ___    __ 
  \_   \/\ \ \/ __\ /__\ __/__   \_   \/___\/\ \ \
   / /\/  \/ / /   /_\| '_ \ / /\// /\//  //  \/ /
/\/ /_/ /\  / /___//__| |_) / //\/ /_/ \_// /\  / 
\____/\_\ \/\____/\__/| .__/\/ \____/\___/\_\ \/  
                      |_|                         
40.6 (2026-06-09 07:15:56, build 71e6bf13)

2026-06-11 02:46:43 INFO [SYSTEM] boot - Settings: /home/piotr/.inception/settings.properties (file does not exist)
2026-06-11 02:46:43 INFO [SYSTEM] boot - Max. application memory: 1970MB
2026-06-11 02:46:43 INFO [SYSTEM] INCEpTION - Starting INCEpTION using Java 25.0.3 with PID 291695 (/home/piotr/tools/INCEpTION/inception-app-webapp-40.6-standalone.jar started by piotr in /home/piotr/tools/INCEpTION)
2026-06-11 02:46:43 INFO [SYSTEM] INCEpTION - The following 3 profiles are active: "embedded-server", "app", "production"

Just a few notes:

...
2026-06-11 02:47:09 INFO [SYSTEM] boot - Document repository path: /home/piotr/.inception/repository
...
2026-06-11 02:47:10 INFO [SYSTEM] boot - Database URL     : [jdbc:hsqldb:file:/home/piotr/.inception/db/inception;hsqldb.default_table_type=cached;hsqldb.tx=mvcc] 
2026-06-11 02:47:10 INFO [SYSTEM] boot - Database username: [sa] 
2026-06-11 02:47:10 INFO [SYSTEM] boot - Database driver  : [HSQL Database Engine Driver  2.7.4] (auto-detected)
2026-06-11 02:47:10 INFO [SYSTEM] boot - Database dialect : [de.tudarmstadt.ukp.inception.support.db.InceptionHSQLDialect] 
...
2026-06-11 02:47:11 INFO [SYSTEM] boot - Initializing inception security web ui built in
2026-06-11 02:47:11 WARN [SYSTEM] InitializeUserDetailsBeanManagerConfigurer$InitializeUserDetailsManagerConfigurer - Global AuthenticationManager configured with an AuthenticationProvider bean. UserDetailsService beans will not be used by Spring Security for automatically configuring username/password login. Consider removing the AuthenticationProvider bean. Alternatively, consider using the UserDetailsService in a manually instantiated DaoAuthenticationProvider. If the current configuration is intentional, to turn off this warning, increase the logging level of 'org.springframework.security.config.annotation.authentication.configuration.InitializeUserDetailsBeanManagerConfigurer' to ERROR
...
The following was not intentional! Dang it, not a clean install, then:

2026-06-11 02:47:14 INFO [SYSTEM] boot - Detected that [state_updated] information in projects is not present. Rebuilding from event log. This may take a moment...
2026-06-11 02:47:14 INFO [SYSTEM] boot - Processing project: [CoMParS](2)
2026-06-11 02:47:15 INFO [SYSTEM] boot - Processing project: [CoMParS-test](0)
2026-06-11 02:47:15 INFO [SYSTEM] boot - Processing project: [CoMParS-test from UD up](1)
2026-06-11 02:47:15 INFO [SYSTEM] boot - Projects updated: 3
2026-06-11 02:47:15 INFO [SYSTEM] boot - Source documents updated: 8
2026-06-11 02:47:15 INFO [SYSTEM] boot - Annotation documents updated: 13
2026-06-11 02:47:15 INFO [SYSTEM] boot - Rebuilding complete.

...
2026-06-11 02:47:16 INFO [SYSTEM] INCEpTION - Started INCEpTION in 34.604 seconds (process running for 45.225)
2026-06-11 02:47:16 WARN [SYSTEM] SpringDocAppInitializer - SpringDoc /v3/api-docs endpoint is enabled by default. To disable it in production, set the property 'springdoc.api-docs.enabled=false'
2026-06-11 02:47:16 WARN [SYSTEM] SpringDocAppInitializer - SpringDoc /swagger-ui.html endpoint is enabled by default. To disable it in production, set the property 'springdoc.swagger-ui.enabled=false'
2026-06-11 02:47:16 INFO [SYSTEM] boot - Console: available
2026-06-11 02:47:16 INFO [SYSTEM] boot - Headless: no
2026-06-11 02:47:16 INFO [SYSTEM] boot - Running in server environment or from command line: disabling interactive shutdown dialog.
2026-06-11 02:47:16 INFO [SYSTEM] boot - You can close INCEpTION from the command line by pressing Ctrl+C
2026-06-11 02:47:16 INFO [SYSTEM] boot - You can now access INCEpTION at http://localhost:8080/

Very useful piece of info: java -DrestoreDefaultAdminAccount -jar inception-app-webapp-40.6-standalone.jar -- when you don't remember the admin passwd...

Clone this wiki locally