{"id":41069597,"url":"https://github.com/fpodschwadek/docker-voyant","last_synced_at":"2026-01-22T13:01:08.015Z","repository":{"id":177606493,"uuid":"618839409","full_name":"fpodschwadek/docker-voyant","owner":"fpodschwadek","description":"A dockerised version of Voyant Server","archived":false,"fork":false,"pushed_at":"2023-06-30T13:05:20.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-06-30T14:29:30.465Z","etag":null,"topics":["corpus-analysis","digital-humanities","docker","text-analysis","text-visualisation","voyant"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fpodschwadek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-25T14:03:07.000Z","updated_at":"2023-06-24T16:03:05.000Z","dependencies_parsed_at":"2026-01-22T13:00:46.086Z","dependency_job_id":null,"html_url":"https://github.com/fpodschwadek/docker-voyant","commit_stats":null,"previous_names":["fpodschwadek/docker-voyant"],"tags_count":1,"template":null,"template_full_name":null,"purl":"pkg:github/fpodschwadek/docker-voyant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpodschwadek%2Fdocker-voyant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpodschwadek%2Fdocker-voyant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpodschwadek%2Fdocker-voyant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpodschwadek%2Fdocker-voyant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fpodschwadek","download_url":"https://codeload.github.com/fpodschwadek/docker-voyant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpodschwadek%2Fdocker-voyant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28663774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["corpus-analysis","digital-humanities","docker","text-analysis","text-visualisation","voyant"],"created_at":"2026-01-22T13:00:39.276Z","updated_at":"2026-01-22T13:01:08.006Z","avatar_url":"https://github.com/fpodschwadek.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-voyant\n\nA dockerised version of [Voyant Server](https://github.com/voyanttools/VoyantServer), an incredibly useful digital humanities tool.\n\nWhile Voyant Server is already built to run on a local machine, it depends on locally installed Java and Eclipse Jetty. \n\nNot 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. \n\nOne way of avoiding this is running software as [Docker](https://www.docker.com/) applications.\n\nA 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. \n\n## How to Turn This Thing On?\n\n### Installing Docker\n\nIf you haven't already, install [Docker](https://docs.docker.com/get-docker/). \n\n(In case you very much distrust Microsoft and want to keep things as free as possible, you can also go for [Podman](https://podman.io/docs/installation).)\n\nIn the following steps I assume you have Docker installed and running.\n\n### Building the Docker Image\n\nThere will be no pre-built images provided by me. You can easily build the image yourself, however.\n\n```bash\ndocker build -t docker-voyant .\n```\n\nThis will take a few minutes.\n\nDocker downloads the Tomcat image [tomcat:9-jre11](https://hub.docker.com/layers/library/tomcat/9-jre11/images/sha256-aa33ee99685f00a3553a97e414b3d821537f73af987c411c43ccd87eb2d66753), installs some additional packages, and add some folders.\n\nIt also downloads a [release archive](https://github.com/voyanttools/VoyantServer/releases) of Voyant Server and prepares the content for running in Tomcat.\n\nYou only need to do this once (unless you want to change the version of Voyant Server that's running inside the container).\n\nIf 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.\n\nIf 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](https://docs.docker.com/engine/reference/builder/#arg)).\n\n\n### Starting the Docker Application\n\nOnce you have built the Docker image, it is locally available on your machine.\n\nTo start the application, you can either run \n\n```bash\ndocker run -dit --rm --name voyant -p 80:8080 docker-voyant\n```\n\nor use `docker compose` (if you have it installed)\n\n```bash\ndocker compose up -d\n```\n\nOnce the application is running, you can access Voyant Server via your browser at `http://localhost`.\n\nFor more details on how to start, stop, and destroy applications, have a look at the [Docker CLI reference](https://docs.docker.com/engine/reference/commandline/cli/).\n\nFeel free to modify your local Docker and Docker compose files according to your needs.\n\n## Version Restrictions\n\nAs per the [original docs](https://github.com/voyanttools/VoyantServer#java-version) I restricted the Java version to 11. \n\nThe Tomcat version had to be restricted to 9, higher versions throw errors.\n\n## License\n\nAll files in this repository are released under General Public License v3.0, same as [Voyant Server itself](https://github.com/voyanttools/VoyantServer#license).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffpodschwadek%2Fdocker-voyant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffpodschwadek%2Fdocker-voyant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffpodschwadek%2Fdocker-voyant/lists"}