Convenience Docker images for Apache Tika Server

Clone this repo:
  1. 1d9b015 Updates for 2.9.2.1 release by tallison · 5 weeks ago main 2.9.2.1
  2. 08d7385 first draft build local multi-arch images (#21) by Tim Allison · 5 weeks ago
  3. 62f4cc8 upgrade to noble (#22) by Tim Allison · 5 weeks ago
  4. 83d1eda prep for 2.9.2.0 release by tallison · 3 months ago
  5. e8819e3 Update README.md (#20) by Cihad Güzel · 8 months ago master

tika-docker

This repo is used to create convenience Docker images for Apache Tika Server published as apache/tika on DockerHub by the Apache Tika Dev team

The images create a functional Apache Tika Server instance that contains the latest Ubuntu running the appropriate version's server on Port 9998 using Java 8 (until version 1.20), Java 11 (1.21 and 1.24.1), Java 14 (until 1.27/2.0.0), Java 16 (for 2.1.0), and Java 17 LTS for newer versions.

There is a minimal version, which contains only Apache Tika and it's core dependencies, and a full version, which also includes dependencies for the GDAL and Tesseract OCR parsers. To balance showing functionality versus the size of the full image, this file currently installs the language packs for the following languages:

  • English
  • French
  • German
  • Italian
  • Spanish.

To install more languages simply update the apt-get command to include the package containing the language you required, or include your own custom packs using an ADD command.

Available Tags

Below are the most recent 2.x series tags:

  • latest, 2.9.2.1: Apache Tika Server 2.9.2.0 (Minimal)
  • latest-full, 2.9.2.1-full: Apache Tika Server 2.9.2.0 (Full)
  • 2.9.2.1, 2.9.2.1: Apache Tika Server 2.9.2.0 (Minimal)
  • 2.9.2.1, 2.9.2.1-full: Apache Tika Server 2.9.2.0 (Full)
  • 2.9.2.0, 2.9.2.0: Apache Tika Server 2.9.2.0 (Minimal)
  • 2.9.2.0, 2.9.2.0-full: Apache Tika Server 2.9.2.0 (Full)
  • 2.9.1.0, 2.9.1.0: Apache Tika Server 2.9.1.0 (Minimal)
  • 2.9.1.0, 2.9.1.0-full: Apache Tika Server 2.9.1.0 (Full)
  • 2.9.0.0, 2.9.0.0: Apache Tika Server 2.9.0.0 (Minimal)
  • 2.9.0.0, 2.9.0.0-full: Apache Tika Server 2.9.0.0 (Full)
  • 2.8.0.0, 2.8.0.0: Apache Tika Server 2.8.0.0 (Minimal)
  • 2.8.0.0, 2.8.0.0-full: Apache Tika Server 2.8.0.0 (Full)
  • 2.7.0.1, 2.7.0.1: Apache Tika Server 2.7.0.1 (Minimal)
  • 2.7.0.1, 2.7.0.1-full: Apache Tika Server 2.7.0.1 (Full)
  • 2.7.0.0, 2.7.0.0: Apache Tika Server 2.7.0.0 (Minimal)
  • 2.7.0.0, 2.7.0.0-full: Apache Tika Server 2.7.0.0 (Full)
  • 2.6.0.1: Apache Tika Server 2.6.0.1 (Minimal)
  • 2.6.0.1-full: Apache Tika Server 2.6.0.1 (Full)
  • 2.6.0.0: Apache Tika Server 2.6.0.0 (Minimal)
  • 2.6.0.0-full: Apache Tika Server 2.6.0.0 (Full)
  • 2.5.0.2: Apache Tika Server 2.5.0.2 (Minimal)
  • 2.5.0.2-full: Apache Tika Server 2.5.0.2 (Full)
  • 2.5.0.1: Apache Tika Server 2.5.0.1 (Minimal)
  • 2.5.0.1-full: Apache Tika Server 2.5.0.1 (Full)
  • 2.5.0: Apache Tika Server 2.5.0 (Minimal)
  • 2.5.0-full: Apache Tika Server 2.5.0 (Full)
  • 2.4.1: Apache Tika Server 2.4.1 (Minimal)
  • 2.4.1-full: Apache Tika Server 2.4.1 (Full)
  • 2.4.0: Apache Tika Server 2.4.0 (Minimal)
  • 2.4.0-full: Apache Tika Server 2.4.0 (Full)
  • 2.3.0: Apache Tika Server 2.3.0 (Minimal)
  • 2.3.0-full: Apache Tika Server 2.3.0 (Full)
  • 2.2.1: Apache Tika Server 2.2.1 (Minimal)
  • 2.2.1-full: Apache Tika Server 2.2.1 (Full)

Below are the most recent 1.x series tags. Note that as of 30 September 2022, the 1.x branch is no longer supported.

  • 1.28.5: Apache Tika Server 1.28.5 (Minimal)
  • 1.28.5-full: Apache Tika Server 1.28.5 (Full)
  • 1.28.4: Apache Tika Server 1.28.4 (Minimal)
  • 1.28.4-full: Apache Tika Server 1.28.4 (Full)
  • 1.28.3: Apache Tika Server 1.28.3 (Minimal)
  • 1.28.3-full: Apache Tika Server 1.28.3 (Full)
  • 1.28.2: Apache Tika Server 1.28.2 (Minimal)
  • 1.28.2-full: Apache Tika Server 1.28.2 (Full)
  • 1.28.1: Apache Tika Server 1.28.1 (Minimal)
  • 1.28.1-full: Apache Tika Server 1.28.1 (Full)

You can see a full set of tags for historical versions here.

Usage

Default

You can pull down the version you would like using:

docker pull apache/tika:<tag>

Then to run the container, execute the following command:

docker run -d -p 127.0.0.1:9998:9998 apache/tika:<tag>

Where is the DockerHub tag corresponding to the Apache Tika Server version - e.g. 1.23, 1.22, 1.23-full, 1.22-full.

NOTE: The latest and latest-full tags are explicitly set to the latest released version when they are published.

NOTE: In the example above, we recommend binding the server to localhost because Docker alters iptables and may expose your tika-server to the internet. If you are confident that your tika-server is on an isolated network you can simply run:

docker run -d -p 9998:9998 apache/tika:<tag>

Custom Config

From version 1.25 and 1.25-full of the image it is now easier to override the defaults and pass parameters to the running instance.

So for example if you wish to disable the OCR parser in the full image you could write a custom configuration:

cat <<EOT >> tika-config.xml
<?xml version="1.0" encoding="UTF-8"?>
<properties>
  <parsers>
      <parser class="org.apache.tika.parser.DefaultParser">
          <parser-exclude class="org.apache.tika.parser.ocr.TesseractOCRParser"/>
      </parser>
  </parsers>
</properties>
EOT

Then by mounting this custom configuration as a volume, you could pass the command line parameter to load it

docker run -d -p 127.0.0.1:9998:9998 -v `pwd`/tika-config.xml:/tika-config.xml apache/tika:2.5.0-full --config /tika-config.xml

You can see more configuration examples here.

As of 2.5.0.2, if you‘d like to add extra jars from your local my-jars directory to Tika’s classpath, mount to /tika-extras like so:

docker run -d -p 127.0.0.1:9998:9998 -v `pwd`/my-jars:/tika-extras apache/tika:2.5.0.2-full

You may want to do this to add optional components, such as the tika-eval metadata filter, or optional dependencies such as jai-imageio-jpeg2000 (check license compatibility first!).

Docker Compose Examples

There are a number of sample Docker Compose files included in the repos to allow you to test some different scenarios.

These files use docker-compose 3.x series and include:

  • docker-compose-tika-vision.yml - TensorFlow Inception REST API Vision examples
  • docker-compose-tika-grobid.yml - Grobid REST parsing example
  • docker-compose-tika-customocr.yml - Tesseract OCR example with custom configuration
  • docker-compose-tika-ner.yml - Named Entity Recognition example

The Docker Compose files and configurations (sourced from sample-configs directory) all have comments in them so you can try different options, or use them as a base to create your own custom configuration.

N.B. You will want to create a environment variable (used in some bash scripts) matching the version of tika-docker you want to work with in the docker compositions e.g. export TAG=1.26. Similarly you should also consult .env which is used in the docker-compose .yml files.

You can install docker-compose from here.

Building

To build the image from scratch, simply invoke:

docker build -t 'apache/tika' github.com/apache/tika-docker

You can then use the following command (using the name you allocated in the build command as part of -t option):

docker run -d -p 127.0.0.1:9998:9998 apache/tika

More Information

For more infomation on Apache Tika Server, go to the Apache Tika Server documentation.

For more information on Apache Tika, go to the official Apache Tika project website.

To meet up with others using Apache Tika, consider coming to one of the Apache Tika Virtual Meetups.

For more information on the Apache Software Foundation, go to the Apache Software Foundation website.

For a full list of changes as of 2.5.0.1, visit CHANGES.md.

For our current release process, visit tika-docker Release Process

Authors

Apache Tika Dev Team (dev@tika.apache.org)

Contributors

There have been a range of contributors on GitHub and via suggestions, including:

License

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Disclaimer

It is worth noting that whilst these Docker images download the binary JARs published by the Apache Tika Team on the Apache Software Foundation distribution sites, only the source release of an Apache Software Foundation project is an official release artefact. See Release Distribution Policy for more details.