TIKA-4272: add a tika grpc docker image
diff --git a/CHANGES.md b/CHANGES.md
new file mode 100644
index 0000000..ccfb39a
--- /dev/null
+++ b/CHANGES.md
@@ -0,0 +1,5 @@
+# Changes
+
+* 3.0.0
+
+Inital release of the Tika Grpc service
\ No newline at end of file
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..261eeb9
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,201 @@
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ 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.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5097817
--- /dev/null
+++ b/README.md
@@ -0,0 +1,141 @@
+# tika-grpc-docker
+
+This repo is used to create convenience Docker images for Apache Tika Grpc Server published as [apache/tika-grpc](https://hub.docker.com/r/apache/tika-grpc) on DockerHub by the [Apache Tika](http://tika.apache.org) Dev team
+
+The images create a functional Apache Tika Grpc Server instance that contains the latest Ubuntu running the appropriate version's server on Port 50052 using Java 17 LTS.
+
+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`, `3.0.0`: Apache Tika Server 3.0.0 (Minimal)
+- `latest-full`, `3.0.0-full`: Apache Tika Server 3.0.0 (Full)
+
+You can see a full set of tags for historical versions [here](https://hub.docker.com/r/apache/tika-grpc/tags?page=1&ordering=last_updated).
+
+## Usage
+
+### Default
+
+You can pull down the version you would like using:
+
+ docker pull apache/tika-grpc:<tag>
+
+Then to run the container, execute the following command:
+
+ docker run -d -p 127.0.0.1:50052:50052 apache/tika-grpc:<tag>
+
+Where <tag> is the DockerHub tag corresponding to the Apache Tika Server version - e.g. 3.0.0, 3.0.0-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 50052:50052 apache/tika-grpc:<tag>
+
+### Custom Config
+
+From version 3.0.0, 3.0.0-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:50052:50052 -v `pwd`/tika-config.xml:/tika-config.xml apache/tika-grpc:3.0.0-full -c /tika-config.xml
+
+You can see more configuration examples [here](https://tika.apache.org/2.5.0/configuring.html).
+
+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=3.0.0`. Similarly you should also consult `.env` which is used in the docker-compose `.yml` files.
+
+You can install docker-compose from [here](https://docs.docker.com/compose/install/).
+
+## Building
+
+To build the image from scratch, simply invoke:
+
+ docker build -t 'apache/tika-grpc' github.com/apache/tika-grpc-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:50052:50052 apache/tika-grpc
+
+## More Information
+
+For more infomation on Apache Tika Grpc Server, go to the [Apache Tika Grpc Server documentation](https://cwiki.apache.org/confluence/display/TIKA/Apache+Tika+gRPC+Server).
+
+For more information on Apache Tika, go to the official [Apache Tika](http://tika.apache.org) project website.
+
+To meet up with others using Apache Tika, consider coming to one of the [Apache Tika Virtual Meetups](https://www.meetup.com/apache-tika-community/).
+
+For more information on the Apache Software Foundation, go to the [Apache Software Foundation](http://apache.org) website.
+
+For a full list of changes as of 3.0.0, visit [CHANGES.md](CHANGES.md).
+
+For our current release process, visit [tika-docker Release Process](https://cwiki.apache.org/confluence/display/TIKA/Release+Process+for+tika-docker)
+
+## Authors
+
+Apache Tika Dev Team (dev@tika.apache.org)
+
+## Contributors
+
+There have been a range of [contributors](https://github.com/apache/tika-grpc-docker/graphs/contributors) on GitHub and via suggestions, including:
+
+- [@nddipiazza](https://github.com/nddipiazza)
+- [@tallisonapache](https://github.com/tballison)
+
+## 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](https://www.apache.org/dev/release-distribution.html) for more details.
diff --git a/docker-compose-tika-customocr.yml b/docker-compose-tika-customocr.yml
new file mode 100644
index 0000000..535c8b3
--- /dev/null
+++ b/docker-compose-tika-customocr.yml
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+version: "3.8"
+services:
+
+ ## Apache Tika Server
+ tika:
+ image: apache/tika-grpc:${TAG}-full
+ # Override default so we can add configuration on classpath
+ entrypoint: [ "/bin/sh", "-c", "exec java -cp \"/customocr:/tika-server-grpc-${TIKA_VERSION}.jar:/tika-extras/*" org.apache.tika.server.core.TikaServerCli -h 0.0.0.0 $$0 $$@"]
+ # Kept command as example but could be added to entrypoint too
+ command: -c /tika-config.xml
+ restart: on-failure
+ ports:
+ - "50052:50052"
+ volumes:
+ # Choose the configuration you want, or add your own custom one
+ # - ./sample-configs/customocr/tika-config-inline.xml:/tika-config.xml
+ - ./sample-configs/customocr/tika-config-rendered.xml:/tika-config.xml
+
+
\ No newline at end of file
diff --git a/docker-compose-tika-grobid.yml b/docker-compose-tika-grobid.yml
new file mode 100644
index 0000000..fbf962e
--- /dev/null
+++ b/docker-compose-tika-grobid.yml
@@ -0,0 +1,40 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+version: "3.8"
+services:
+
+ ## Apache Tika Server
+ tika:
+ image: apache/tika-grpc:${TAG}-full
+ # Override default so we can add configuration on classpath
+ entrypoint: [ "/bin/sh", "-c", "exec java -cp \"/grobid:/tika-server-standard-${TIKA_VERSION}.jar:/tika-extras/*" org.apache.tika.server.core.TikaServerCli -h 0.0.0.0 $$0 $$@"]
+ # Kept command as example but could be added to entrypoint too
+ command: -c /grobid/tika-config.xml
+ restart: on-failure
+ ports:
+ - "50052:50052"
+ volumes:
+ - ./sample-configs/grobid:/grobid
+ depends_on:
+ - grobid
+
+ ## Grobid Service
+ grobid:
+ image: lfoppiano/grobid:0.6.1
+ ports:
+ - "8070:8070"
+ - "8071:8071"
+
diff --git a/docker-compose-tika-ner.yml b/docker-compose-tika-ner.yml
new file mode 100644
index 0000000..4acd842
--- /dev/null
+++ b/docker-compose-tika-ner.yml
@@ -0,0 +1,30 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+version: "3.8"
+services:
+
+ ## Apache Tika Server
+ tika:
+ image: apache/tika-grpc:${TAG}-full
+ # Use custom script as entrypoint to go fetch models and setup recognisers
+ entrypoint: [ "/ner/run_tika_server.sh"]
+ restart: on-failure
+ ports:
+ - "50052:50052"
+ volumes:
+ - ./sample-configs/ner/:/ner/
+ environment:
+ - TAG
\ No newline at end of file
diff --git a/docker-compose-tika-vision.yml b/docker-compose-tika-vision.yml
new file mode 100644
index 0000000..e0824d5
--- /dev/null
+++ b/docker-compose-tika-vision.yml
@@ -0,0 +1,54 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+version: "3.8"
+services:
+
+ ## Apache Tika Server
+ tika:
+ image: apache/tika-grpc:latest-full
+ command: -c /tika-config.xml
+ restart: on-failure
+ ports:
+ - "50052:50052"
+
+ volumes:
+ # Replace the below with the configuration you want to use, or with your own custom one
+ # - ./sample-configs/vision/inception-rest.xml:/tika-config.xml
+ # - ./sample-configs/vision/inception-rest-video.xml:/tika-config.xml
+ - ./sample-configs/vision/inception-rest-caption.xml:/tika-config.xml
+
+ depends_on:
+ # You can comment out any you don't need here and in the Vision Service section below
+ - inception-rest
+ - inception-caption
+ - inception-video
+
+ ## Vision Services
+ inception-rest:
+ build: https://raw.githubusercontent.com/dameikle/tika-dockers/patch-1/InceptionRestDockerfile
+ ports:
+ - "8764:8764"
+
+ inception-caption:
+ build: https://raw.githubusercontent.com/dameikle/tika-dockers/patch-1/Im2txtRestDockerfile
+ ports:
+ - "8765:8764"
+
+ inception-video:
+ build: https://raw.githubusercontent.com/dameikle/tika-dockers/patch-1/InceptionVideoRestDockerfile
+ ports:
+ - "8766:8764"
+
diff --git a/docker-tool.sh b/docker-tool.sh
new file mode 100755
index 0000000..557fdc5
--- /dev/null
+++ b/docker-tool.sh
@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you 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.
+
+stop_and_die() {
+ docker buildx rm tika-builder || die "couldn't stop builder -- make sure to stop the builder manually! "
+ die "$*"
+}
+
+die() {
+ echo "$*" >&2
+ exit 1
+}
+
+while getopts ":h" opt; do
+ case ${opt} in
+ h )
+ echo "Usage:"
+ echo " docker-tool.sh -h Display this help message."
+ echo " docker-tool.sh build <TIKA_DOCKER_VERSION> <TIKA_VERSION> Builds <TIKA_DOCKER_VERSION> images for <TIKA_VERSION>."
+ echo " docker-tool.sh test <TIKA_DOCKER_VERSION> Tests images for <TIKA_DOCKER_VERSION>."
+ echo " docker-tool.sh publish <TIKA_DOCKER_VERSION> <TIKA_VERSION> Builds multi-arch images for <TIKA_DOCKER_VERSION> and pushes to Docker Hub."
+ exit 0
+ ;;
+ \? )
+ echo "Invalid Option: -$OPTARG" 1>&2
+ exit 1
+ ;;
+ esac
+done
+
+
+test_docker_image() {
+ docker run -d --name "$1" -p 127.0.0.1:50052:50052 apache/tika-grpc:"$1"
+ sleep 10
+ url=http://localhost:50052/
+ status=$(curl --head --location --connect-timeout 5 --write-out %{http_code} --silent --output /dev/null ${url})
+ user=$(docker inspect "$1" --format '{{.Config.User}}')
+
+ if [[ $status == '200' ]]
+ then
+ echo "$(tput setaf 2)Image: apache/tika-grpc:${1} - Basic test passed$(tput sgr0)"
+ else
+ echo "$(tput setaf 1)Image: apache/tika-grpc:${1} - Basic test failed$(tput sgr0)"
+ docker kill "$1"
+ docker rm "$1"
+ exit 1
+ fi
+
+ #now test that the user is correctly set
+ if [[ $user == '35002:35002' ]]
+ then
+ echo "$(tput setaf 2)Image: apache/tika-grpc:${1} - User passed$(tput sgr0)"
+ docker kill "$1"
+ docker rm "$1"
+ else
+ echo "$(tput setaf 1)Image: apache/tika-grpc:${1} - User failed$(tput sgr0)"
+ docker kill "$1"
+ docker rm "$1"
+ exit 1
+ fi
+}
+
+shift $((OPTIND -1))
+subcommand=$1; shift
+tika_docker_version=$1; shift
+tika_version=$1; shift
+
+
+case "$subcommand" in
+ build)
+ # Build slim tika- with minimal dependencies
+ docker build -t apache/tika-grpc:${tika_docker_version} --build-arg TIKA_VERSION=${tika_version} - < minimal/Dockerfile --no-cache || die "couldn't build minimal"
+ # Build full tika- with OCR, Fonts and GDAL
+ docker build -t apache/tika-grpc:${tika_docker_version}-full --build-arg TIKA_VERSION=${tika_version} - < full/Dockerfile --no-cache || die "couldn't build full"
+ ;;
+
+ test)
+ # Test the images
+ test_docker_image ${tika_docker_version}
+ test_docker_image "${tika_docker_version}-full"
+ ;;
+
+ publish)
+ docker buildx create --use --name tika-builder || die "couldn't create builder"
+ # Build multi-arch with buildx and push
+ docker buildx build --platform linux/arm/v7,linux/arm64/v8,linux/amd64 --output "type=image,push=true" \
+ --tag apache/tika-grpc:latest --tag apache/tika-grpc:${tika_docker_version} --build-arg TIKA_VERSION=${tika_version} --no-cache --builder tika-builder minimal || stop_and_die "couldn't build multi-arch minimal"
+ docker buildx build --platform linux/arm/v7,linux/arm64/v8,linux/amd64 --output "type=image,push=true" \
+ --tag apache/tika-grpc:latest-full --tag apache/tika-grpc:${tika_docker_version}-full --build-arg TIKA_VERSION=${tika_version} --no-cache --builder tika-builder full || stop_and_die "couldn't build multi-arch full"
+ docker buildx rm tika-builder || die "couldn't stop builder -- make sure to stop the builder manually! "
+ ;;
+
+esac
diff --git a/full/Dockerfile b/full/Dockerfile
new file mode 100644
index 0000000..2c796cd
--- /dev/null
+++ b/full/Dockerfile
@@ -0,0 +1,80 @@
+# 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.
+
+# "random" uid/gid hopefully not used anywhere else
+# This needs to be set globally and then referenced in
+# the subsequent stages -- see TIKA-3912
+ARG UID_GID="35002:35002"
+
+FROM ubuntu:noble as base
+
+FROM base as fetch_tika
+
+ARG TIKA_VERSION
+ARG CHECK_SIG=true
+
+ENV NEAREST_TIKA_SERVER_URL="https://dlcdn.apache.org/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar" \
+ ARCHIVE_TIKA_SERVER_URL="https://archive.apache.org/dist/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar" \
+ BACKUP_TIKA_SERVER_URL="https://downloads.apache.org/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar" \
+ DEFAULT_TIKA_SERVER_ASC_URL="https://downloads.apache.org/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar.asc" \
+ ARCHIVE_TIKA_SERVER_ASC_URL="https://archive.apache.org/dist/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar.asc" \
+ TIKA_VERSION=$TIKA_VERSION
+
+RUN DEBIAN_FRONTEND=noninteractive apt-get update && apt-get -y install gnupg2 wget ca-certificates \
+ && wget -t 10 --max-redirect 1 --retry-connrefused -qO- https://downloads.apache.org/tika/KEYS | gpg --import \
+ && wget -t 10 --max-redirect 1 --retry-connrefused $NEAREST_TIKA_SERVER_URL -O /tika-server-grpc-${TIKA_VERSION}.jar || rm /tika-server-grpc-${TIKA_VERSION}.jar \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar ]" || wget $ARCHIVE_TIKA_SERVER_URL -O /tika-server-grpc-${TIKA_VERSION}.jar || rm /tika-server-grpc-${TIKA_VERSION}.jar \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar ]" || wget $BACKUP_TIKA_SERVER_URL -O /tika-server-grpc-${TIKA_VERSION}.jar || rm /tika-server-grpc-${TIKA_VERSION}.jar \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar ]" || exit 1 \
+ && wget -t 10 --max-redirect 1 --retry-connrefused $DEFAULT_TIKA_SERVER_ASC_URL -O /tika-server-grpc-${TIKA_VERSION}.jar.asc || rm /tika-server-grpc-${TIKA_VERSION}.jar.asc \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar.asc ]" || wget $ARCHIVE_TIKA_SERVER_ASC_URL -O /tika-server-grpc-${TIKA_VERSION}.jar.asc || rm /tika-server-grpc-${TIKA_VERSION}.jar.asc \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar.asc ]" || exit 1 \
+ && gpg --verify /tika-server-grpc-${TIKA_VERSION}.jar.asc /tika-server-grpc-${TIKA_VERSION}.jar
+
+#RUN if [ "$CHECK_SIG" = "true" ] ; then gpg --verify /tika-server-grpc-${TIKA_VERSION}.jar.asc /tika-server-grpc-${TIKA_VERSION}.jar; fi
+
+FROM base as runtime
+ARG UID_GID
+ARG JRE='openjdk-17-jre-headless'
+RUN set -eux \
+ && apt-get update \
+ && apt-get install --yes --no-install-recommends gnupg2 software-properties-common \
+ && apt-get update \
+ && DEBIAN_FRONTEND=noninteractive apt-get install --yes --no-install-recommends $JRE \
+ gdal-bin \
+ tesseract-ocr \
+ tesseract-ocr-eng \
+ tesseract-ocr-ita \
+ tesseract-ocr-fra \
+ tesseract-ocr-spa \
+ tesseract-ocr-deu \
+ && echo ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true | debconf-set-selections \
+ && DEBIAN_FRONTEND=noninteractive apt-get install --yes --no-install-recommends \
+ xfonts-utils \
+ fonts-freefont-ttf \
+ fonts-liberation \
+ ttf-mscorefonts-installer \
+ wget \
+ cabextract \
+ && apt-get clean -y \
+ && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+ARG TIKA_VERSION
+ENV TIKA_VERSION=$TIKA_VERSION
+
+COPY --from=fetch_tika /tika-server-grpc-${TIKA_VERSION}.jar /tika-server-grpc-${TIKA_VERSION}.jar
+USER $UID_GID
+
+EXPOSE 50052
+ENTRYPOINT [ "/bin/sh", "-c", "exec java -cp \"/tika-server-grpc-${TIKA_VERSION}.jar:/tika-extras/*\" org.apache.tika.pipes.grpc.TikaGrpcServer $0 $@"]
+
+LABEL maintainer="Apache Tika Developers dev@tika.apache.org"
+
diff --git a/minimal/Dockerfile b/minimal/Dockerfile
new file mode 100644
index 0000000..3423bd0
--- /dev/null
+++ b/minimal/Dockerfile
@@ -0,0 +1,70 @@
+
+# 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.
+
+# "random" uid/gid hopefully not used anywhere else
+# This needs to be set globally and then referenced in
+# the subsequent stages -- see TIKA-3912
+ARG UID_GID="35002:35002"
+
+FROM ubuntu:noble as base
+
+FROM base as fetch_tika
+
+ARG TIKA_VERSION
+ARG CHECK_SIG=true
+
+ENV NEAREST_TIKA_SERVER_URL="https://dlcdn.apache.org/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar" \
+ ARCHIVE_TIKA_SERVER_URL="https://archive.apache.org/dist/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar" \
+ BACKUP_TIKA_SERVER_URL="https://downloads.apache.org/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar" \
+ DEFAULT_TIKA_SERVER_ASC_URL="https://downloads.apache.org/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar.asc" \
+ ARCHIVE_TIKA_SERVER_ASC_URL="https://archive.apache.org/dist/tika/${TIKA_VERSION}/tika-server-grpc-${TIKA_VERSION}.jar.asc" \
+ TIKA_VERSION=$TIKA_VERSION
+
+RUN set -eux \
+ && apt-get update \
+ && DEBIAN_FRONTEND=noninteractive apt-get install --yes --no-install-recommends \
+ gnupg2 \
+ wget \
+ ca-certificates \
+ && wget -t 10 --max-redirect 1 --retry-connrefused -qO- https://downloads.apache.org/tika/KEYS | gpg --import \
+ && wget -t 10 --max-redirect 1 --retry-connrefused $NEAREST_TIKA_SERVER_URL -O /tika-server-grpc-${TIKA_VERSION}.jar || rm /tika-server-grpc-${TIKA_VERSION}.jar \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar ]" || wget $ARCHIVE_TIKA_SERVER_URL -O /tika-server-grpc-${TIKA_VERSION}.jar || rm /tika-server-grpc-${TIKA_VERSION}.jar \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar ]" || wget $BACKUP_TIKA_SERVER_URL -O /tika-server-grpc-${TIKA_VERSION}.jar || rm /tika-server-grpc-${TIKA_VERSION}.jar \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar ]" || exit 1 \
+ && wget -t 10 --max-redirect 1 --retry-connrefused $DEFAULT_TIKA_SERVER_ASC_URL -O /tika-server-grpc-${TIKA_VERSION}.jar.asc || rm /tika-server-grpc-${TIKA_VERSION}.jar.asc \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar.asc ]" || wget $ARCHIVE_TIKA_SERVER_ASC_URL -O /tika-server-grpc-${TIKA_VERSION}.jar.asc || rm /tika-server-grpc-${TIKA_VERSION}.jar.asc \
+ && sh -c "[ -f /tika-server-grpc-${TIKA_VERSION}.jar.asc ]" || exit 1 \
+ && gpg --verify /tika-server-grpc-${TIKA_VERSION}.jar.asc /tika-server-grpc-${TIKA_VERSION}.jar
+
+# this used to work, but I'm getting "ERROR: failed to solve: failed to prepare $data as $data2: invalid argument"
+# when trying to build 2.9.2.0
+#RUN if [ "$CHECK_SIG" = "true" ] ; then gpg --verify /tika-server-grpc-${TIKA_VERSION}.jar.asc /tika-server-grpc-${TIKA_VERSION}.jar; fi
+
+FROM base as runtime
+# must reference uid_gid
+ARG UID_GID
+ARG JRE='openjdk-17-jre-headless'
+RUN set -eux \
+ && apt-get update \
+ && apt-get install --yes --no-install-recommends \
+ ${JRE} \
+ ca-certificates \
+ && apt-get clean -y && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+ARG TIKA_VERSION
+ENV TIKA_VERSION=$TIKA_VERSION
+COPY --from=fetch_tika /tika-server-grpc-${TIKA_VERSION}.jar /tika-server-grpc-${TIKA_VERSION}.jar
+USER $UID_GID
+EXPOSE 50052
+ENTRYPOINT [ "/bin/sh", "-c", "exec java -cp \"/tika-server-grpc-${TIKA_VERSION}.jar:/tika-extras/*\" org.apache.tika.pipes.grpc.TikaGrpcServer $0 $@"]
+
+LABEL maintainer="Apache Tika Developers dev@tika.apache.org"
diff --git a/sample-configs/customocr/org/apache/tika/parser/ocr/TesseractOCRConfig.properties b/sample-configs/customocr/org/apache/tika/parser/ocr/TesseractOCRConfig.properties
new file mode 100644
index 0000000..b4b787f
--- /dev/null
+++ b/sample-configs/customocr/org/apache/tika/parser/ocr/TesseractOCRConfig.properties
@@ -0,0 +1,25 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+# You customise or add the settings you want here
+language=eng+spa+fra+deu+ita
+timeout=240
+minFileSizeToOcr=1
+enableImageProcessing=0
+density=200
+depth=8
+filter=box
+resize=300
+applyRotation=true
\ No newline at end of file
diff --git a/sample-configs/customocr/tika-config-inline.xml b/sample-configs/customocr/tika-config-inline.xml
new file mode 100644
index 0000000..7568863
--- /dev/null
+++ b/sample-configs/customocr/tika-config-inline.xml
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <async>
+ <staleFetcherTimeoutSeconds>600</staleFetcherTimeoutSeconds>
+ <staleFetcherDelaySeconds>60</staleFetcherDelaySeconds>
+ </async>
+ <pipes>
+ <params>
+ <numClients>2</numClients>
+ <forkedJvmArgs>
+ <arg>-Xmx1g</arg>
+ <arg>-XX:ParallelGCThreads=2</arg>
+ </forkedJvmArgs>
+ <timeoutMillis>60000</timeoutMillis>
+ <maxForEmitBatchBytes>-1</maxForEmitBatchBytes> <!-- disable emit -->
+ </params>
+ </pipes>
+ <fetchers>
+ </fetchers>
+
+ <parsers>
+ <!-- Load TesseractOCRParser (could use DefaultParser if you want others too) -->
+ <parser class="org.apache.tika.parser.ocr.TesseractOCRParser"/>
+
+ <!-- Extract and OCR Inline Images in PDF -->
+ <parser class="org.apache.tika.parser.pdf.PDFParser">
+ <params>
+ <param name="extractInlineImages" type="bool">true</param>
+ </params>
+ </parser>
+
+ </parsers>
+</properties>
diff --git a/sample-configs/customocr/tika-config-rendered.xml b/sample-configs/customocr/tika-config-rendered.xml
new file mode 100644
index 0000000..af308eb
--- /dev/null
+++ b/sample-configs/customocr/tika-config-rendered.xml
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <async>
+ <staleFetcherTimeoutSeconds>600</staleFetcherTimeoutSeconds>
+ <staleFetcherDelaySeconds>60</staleFetcherDelaySeconds>
+ </async>
+ <pipes>
+ <params>
+ <numClients>2</numClients>
+ <forkedJvmArgs>
+ <arg>-Xmx1g</arg>
+ <arg>-XX:ParallelGCThreads=2</arg>
+ </forkedJvmArgs>
+ <timeoutMillis>60000</timeoutMillis>
+ <maxForEmitBatchBytes>-1</maxForEmitBatchBytes> <!-- disable emit -->
+ </params>
+ </pipes>
+ <fetchers>
+ </fetchers>
+ <parsers>
+ <!-- Load TesseractOCRParser (could use DefaultParser if you want others too) -->
+ <parser class="org.apache.tika.parser.ocr.TesseractOCRParser"/>
+
+ <!-- OCR on Rendered Pages -->
+ <parser class="org.apache.tika.parser.pdf.PDFParser">
+ <params>
+ <!-- no_ocr - extract text only
+ ocr_only - don't extract text and just attempt OCR
+ ocr_and_text - extract text and attempt OCR (from Tika 1.24)
+ auto - extract text but if < 10 characters try OCR
+ -->
+ <param name="ocrStrategy" type="string">ocr_only</param>
+ <param name="ocrImageType" type="string">rgb</param>
+ <param name="ocrDPI" type="int">100</param>
+ </params>
+ </parser>
+
+ </parsers>
+</properties>
diff --git a/sample-configs/grobid/org/apache/tika/parser/journal/GrobidExtractor.properties b/sample-configs/grobid/org/apache/tika/parser/journal/GrobidExtractor.properties
new file mode 100644
index 0000000..44689a2
--- /dev/null
+++ b/sample-configs/grobid/org/apache/tika/parser/journal/GrobidExtractor.properties
@@ -0,0 +1,16 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+grobid.server.url=http://grobid:8070
\ No newline at end of file
diff --git a/sample-configs/grobid/tika-config.xml b/sample-configs/grobid/tika-config.xml
new file mode 100644
index 0000000..1974ce4
--- /dev/null
+++ b/sample-configs/grobid/tika-config.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <async>
+ <staleFetcherTimeoutSeconds>600</staleFetcherTimeoutSeconds>
+ <staleFetcherDelaySeconds>60</staleFetcherDelaySeconds>
+ </async>
+ <pipes>
+ <params>
+ <numClients>2</numClients>
+ <forkedJvmArgs>
+ <arg>-Xmx1g</arg>
+ <arg>-XX:ParallelGCThreads=2</arg>
+ </forkedJvmArgs>
+ <timeoutMillis>60000</timeoutMillis>
+ <maxForEmitBatchBytes>-1</maxForEmitBatchBytes> <!-- disable emit -->
+ </params>
+ </pipes>
+ <fetchers>
+ </fetchers>
+ <parsers>
+ <parser class="org.apache.tika.parser.journal.JournalParser">
+ <mime>application/pdf</mime>
+ </parser>
+ </parsers>
+</properties>
diff --git a/sample-configs/ner/run_tika_server.sh b/sample-configs/ner/run_tika_server.sh
new file mode 100755
index 0000000..4f81d7a
--- /dev/null
+++ b/sample-configs/ner/run_tika_server.sh
@@ -0,0 +1,62 @@
+#!/bin/bash
+
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+
+#############################################################################
+# See https://cwiki.apache.org/confluence/display/TIKA/TikaAndNER for details
+# on how to configure additional NER libraries
+#############################################################################
+
+# ------------------------------------
+# Download OpenNLP Models to classpath
+# ------------------------------------
+
+OPENNLP_LOCATION="/ner/org/apache/tika-grpc/parser/ner/opennlp"
+URL="http://opennlp.sourceforge.net/models-1.5"
+
+mkdir -p $OPENNLP_LOCATION
+if [ "$(ls -A $OPENNLP_LOCATION/*.bin)" ]; then
+ echo "OpenNLP models directory has files, so skipping fetch";
+else
+ echo "No OpenNLP models found, so fetching them"
+ wget "$URL/en-ner-person.bin" -O $OPENNLP_LOCATION/ner-person.bin
+ wget "$URL/en-ner-location.bin" -O $OPENNLP_LOCATION/ner-location.bin
+ wget "$URL/en-ner-organization.bin" -O $OPENNLP_LOCATION/ner-organization.bin;
+ wget "$URL/en-ner-date.bin" -O $OPENNLP_LOCATION/ner-date.bin
+ wget "$URL/en-ner-time.bin" -O $OPENNLP_LOCATION/ner-time.bin
+ wget "$URL/en-ner-percentage.bin" -O $OPENNLP_LOCATION/ner-percentage.bin
+ wget "$URL/en-ner-money.bin" -O $OPENNLP_LOCATION/ner-money.bin
+fi
+
+# --------------------------------------------
+# Create RexExp Example for Email on classpath
+# --------------------------------------------
+REGEXP_LOCATION="/ner/org/apache/tika-grpc/parser/ner/regex"
+mkdir -p $REGEXP_LOCATION
+echo "EMAIL=(?:[a-z0-9!#$%&'*+/=?^_\`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_\`{|}~-]+)*|\"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*\")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])" > $REGEXP_LOCATION/ner-regex.txt
+
+
+# -------------------
+# Now run Tika Server
+# -------------------
+
+# Can be a single implementation or comma seperated list for multiple for "ner.impl.class" property
+RECOGNISERS=org.apache.tika.parser.ner.opennlp.OpenNLPNERecogniser,org.apache.tika.parser.ner.regex.RegexNERecogniser
+# Set classpath to the Tika Server JAR and the /ner folder so it has the configuration and models from above
+CLASSPATH="/ner:/tika-server-standard-${TIKA_VERSION}.jar:/tika-extras/*"
+# Run the server with the custom configuration ner.impl.class property and custom /ner/tika-config.xml
+exec java -Dner.impl.class=$RECOGNISERS -cp $CLASSPATH org.apache.tika.pipes.grpc.TikaGrpcServer -c /ner/tika-config.xml
\ No newline at end of file
diff --git a/sample-configs/ner/tika-config.xml b/sample-configs/ner/tika-config.xml
new file mode 100644
index 0000000..d9d6a2f
--- /dev/null
+++ b/sample-configs/ner/tika-config.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <async>
+ <staleFetcherTimeoutSeconds>600</staleFetcherTimeoutSeconds>
+ <staleFetcherDelaySeconds>60</staleFetcherDelaySeconds>
+ </async>
+ <pipes>
+ <params>
+ <numClients>2</numClients>
+ <forkedJvmArgs>
+ <arg>-Xmx1g</arg>
+ <arg>-XX:ParallelGCThreads=2</arg>
+ </forkedJvmArgs>
+ <timeoutMillis>60000</timeoutMillis>
+ <maxForEmitBatchBytes>-1</maxForEmitBatchBytes> <!-- disable emit -->
+ </params>
+ </pipes>
+ <fetchers>
+ </fetchers>
+ <parsers>
+ <parser class="org.apache.tika.parser.ner.NamedEntityParser">
+ <mime>application/pdf</mime>
+ <mime>text/plain</mime>
+ <mime>text/html</mime>
+ <mime>application/xhtml+xml</mime>
+ </parser>
+ </parsers>
+</properties>
+
diff --git a/sample-configs/vision/inception-rest-caption.xml b/sample-configs/vision/inception-rest-caption.xml
new file mode 100644
index 0000000..c70c207
--- /dev/null
+++ b/sample-configs/vision/inception-rest-caption.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <parsers>
+ <parser class="org.apache.tika.parser.recognition.ObjectRecognitionParser">
+ <mime>image/jpeg</mime>
+ <mime>image/png</mime>
+ <mime>image/gif</mime>
+ <params>
+ <param name="apiBaseUri" type="uri">http://inception-caption:8764/inception/v3</param>
+ <param name="captions" type="int">5</param>
+ <param name="maxCaptionLength" type="int">15</param>
+ <param name="class" type="string">org.apache.tika.parser.captioning.tf.TensorflowRESTCaptioner</param>
+ </params>
+ </parser>
+ </parsers>
+</properties>
\ No newline at end of file
diff --git a/sample-configs/vision/inception-rest-video.xml b/sample-configs/vision/inception-rest-video.xml
new file mode 100644
index 0000000..f6a4e6a
--- /dev/null
+++ b/sample-configs/vision/inception-rest-video.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <parsers>
+ <parser class="org.apache.tika.parser.recognition.ObjectRecognitionParser">
+ <mime>video/mp4</mime>
+ <mime>video/quicktime</mime>
+ <params>
+ <param name="apiBaseUri" type="uri">http://inception-video:8764/inception/v4</param>
+ <param name="topN" type="int">4</param>
+ <param name="minConfidence" type="double">0.015</param>
+ <param name="mode" type="string">fixed</param>
+ <param name="class" type="string">org.apache.tika.parser.recognition.tf.TensorflowRESTVideoRecogniser</param>
+ </params>
+ </parser>
+ </parsers>
+</properties>
\ No newline at end of file
diff --git a/sample-configs/vision/inception-rest.xml b/sample-configs/vision/inception-rest.xml
new file mode 100644
index 0000000..caa6468
--- /dev/null
+++ b/sample-configs/vision/inception-rest.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one or more
+ ~ contributor license agreements. See the NOTICE file distributed with
+ ~ this work for additional information regarding copyright ownership.
+ ~ The ASF licenses this file to You 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.
+ -->
+<properties>
+ <parsers>
+ <parser class="org.apache.tika.parser.recognition.ObjectRecognitionParser">
+ <mime>image/jpeg</mime>
+ <mime>image/png</mime>
+ <mime>image/gif</mime>
+ <params>
+ <param name="apiBaseUri" type="uri">http://inception-rest:8764/inception/v4</param>
+ <param name="topN" type="int">2</param>
+ <param name="minConfidence" type="double">0.015</param>
+ <param name="class" type="string">org.apache.tika.parser.recognition.tf.TensorflowRESTRecogniser</param>
+ </params>
+ </parser>
+ </parsers>
+</properties>
