A dockerised version of Voyant Server, an incredibly useful digital humanities tool.
While Voyant Server is already built to run on a local machine, it depends on locally installed Java and Eclipse Jetty.
Not everyone can or wants to install these dependencies directly on their computer, or they might need different Java versions for different applications they're running.
One way of avoiding this is running software as Docker applications.
A dockerised version of Voyant Server might be useful for researchers, teachers, and students who want to use a local version with few to none side effects and dependencies.
If you haven't already, install Docker.
(In case you very much distrust Microsoft and want to keep things as free as possible, you can also go for Podman.)
In the following steps I assume you have Docker installed and running.
There will be no pre-built images provided by me. You can easily build the image yourself, however.
docker build -t docker-voyant .This will take a few minutes.
Docker downloads the Tomcat image tomcat:9-jre11, installs some additional packages, and add some folders.
It also downloads a release archive of Voyant Server and prepares the content for running in Tomcat.
You only need to do this once (unless you want to change the version of Voyant Server that's running inside the container).
If you want to see which version of Voyant Server is used, have a look at the VERSION_DOTTED and VERSION_UNDERSCORED ARG variables in the Dockerfile.
If you want to change the version, change the values of these variables before (re-)building the Docker image (you can also use the --build-arg parameter).
Once you have built the Docker image, it is locally available on your machine.
To start the application, you can either run
docker run -dit --rm --name voyant -p 80:8080 docker-voyantor use docker compose (if you have it installed)
docker compose up -dOnce the application is running, you can access Voyant Server via your browser at http://localhost.
For more details on how to start, stop, and destroy applications, have a look at the Docker CLI reference.
Feel free to modify your local Docker and Docker compose files according to your needs.
As per the original docs I restricted the Java version to 11.
The Tomcat version had to be restricted to 9, higher versions throw errors.
All files in this repository are released under General Public License v3.0, same as Voyant Server itself.