The KorAP Corpus Analysis Platform consists of several independent components, but they can easily be installed together using Docker. This repository contains a recipe to install all components needed to run KorAP on your own local machine with a single command.
Install docker and docker compose (>= v2; as a CLI plugin).
To get KorAP running, an index is required. For testing, there is a test index available as a docker image. Just run
COMPOSE_PROFILES="open,example" INDEX='example-index' docker compose -p korap upto start the example image and the service with Linux (See here for more information on Windows).
To run without the export plugin, set KALAMAR_EXPORT=false or omit export from COMPOSE_PROFILES:
COMPOSE_PROFILES="open,example" KALAMAR_EXPORT=false INDEX='example-index' docker compose -p korap upIt's also possible to download the sample index provided by
Kustvakt.
To download, intialize and run KorAP pointing to that index folder
(in this example stored in the index folder in the local directory),
run
COMPOSE_PROFILES="open" INDEX=./index docker compose -p korap upThis will make the frontend be available at
localhost:64543.
To use your own index, please follow the instructions on Corpus Conversion first.
To run the service with a user management system, first create a directory
data in your working directory and then start it with
COMPOSE_PROFILES="auth" INDEX=./index docker compose -p korap upLogin with user1 and password1. To change authentication settings, see the /kusvakt/ldap folder inside the docker container and Kustvakt's LDAP Settings Wiki for documentation.
As of June 2026, the corpus conversion, annotation and indexing process has been significantly simplified and is now orchestrated by KorAP-Ingestion. In many cases, a simple make command is sufficient to ingest your TEI XML data and launch your own KorAP instance. For comprehensive instructions and advanced options, please refer to the KorAP-Ingestion documentation.
Windows with Powershell requires environment variables to pass in a different way.
In addition the PWD variable is not set beforehand. To run the KorAP one-liner
with Windows, you have to start
$env:INDEX='example-index'; $env:PWD='.'; $env:COMPOSE_PROFILES='open,example'; docker compose -p korap up
Authors: Nils Diewald, Harald Lüngen, Marc Kupietz
Copyright (c) 2022-2026, IDS Mannheim, Germany
KorAP-Docker is published under the BSD-2 License.
The example corpus corresponds to the release part of the Dortmunder Chatkorpus 2.2 as prepared by DeReKo. The corpus is released under the CC BY 4.0 License. Legal restrictions may arise from data protection legislation.
Beißwenger, Michael / Storrer, Angelika (2008): Corpora of Computer-Mediated Communication. In: Anke Lüdeling & Merja Kytö (Eds): Corpus Linguistics. An International Handbook. Volume 1. Berlin. New York (Handbooks of Linguistics and Communication Science 29.1), pp. 292--308.