{"id":20114930,"url":"https://github.com/vroom-project/vroom-docker","last_synced_at":"2025-10-08T01:37:49.481Z","repository":{"id":38197711,"uuid":"246261687","full_name":"VROOM-Project/vroom-docker","owner":"VROOM-Project","description":"Docker image for vroom and vroom-express","archived":false,"fork":false,"pushed_at":"2024-11-28T15:53:11.000Z","size":54,"stargazers_count":92,"open_issues_count":3,"forks_count":61,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-29T00:06:53.602Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VROOM-Project.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2020-03-10T09:42:38.000Z","updated_at":"2025-02-03T16:02:44.000Z","dependencies_parsed_at":"2023-11-15T17:47:12.676Z","dependency_job_id":"96aec518-8359-4cb9-b9b3-849de61ff210","html_url":"https://github.com/VROOM-Project/vroom-docker","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VROOM-Project%2Fvroom-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VROOM-Project%2Fvroom-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VROOM-Project%2Fvroom-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VROOM-Project%2Fvroom-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VROOM-Project","download_url":"https://codeload.github.com/VROOM-Project/vroom-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247271525,"owners_count":20911587,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-13T18:33:09.959Z","updated_at":"2025-10-08T01:37:44.452Z","avatar_url":"https://github.com/VROOM-Project.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VROOM Docker image\n\n[![Master push](https://github.com/VROOM-Project/vroom-docker/actions/workflows/master_push.yml/badge.svg)](https://github.com/VROOM-Project/vroom-docker/actions/workflows/master_push.yml)\n\n**Note**, this repo is migrating to Github's container registry, releases from v1.14.0 on will not be published at hub.docker.com.\n\nThis image includes all dependencies and projects needed to successfully run an instance of [`vroom-express`](https://github.com/VROOM-Project/vroom-express) on top of [`vroom`](https://github.com/VROOM-Project/vroom). Within 2 minutes you'll have a routing optimization engine running on your machine.\n\n```bash\ndocker run -dt --name vroom \\\n    --net host \\  # or set the container name as host in config.yml and use --port 3000:3000 instead, see below\n    -v $PWD/conf:/conf \\ # mapped volume for config \u0026 log\n    -e VROOM_ROUTER=osrm \\ # routing layer: osrm, valhalla or ors\n    ghcr.io/vroom-project/vroom-docker:v1.14.0\n```\n\nIf you want to build the image yourself, run a\n\n`docker build -t ghcr.io/vroom-project/vroom-docker:v1.14.0 --build-arg VROOM_RELEASE=v1.14.0 --build-arg VROOM_EXPRESS_RELEASE=v0.12.0 .`\n\n\u003e **Note**, you should have access to a self-hosted instance of OSRM, Valhalla or OpenRouteService for the routing server.\n\n## Tagging\n\nThe tagging scheme follows the release convention of `vroom` core.\n\n## Customization\n\n### Environment variables\n\n- `VROOM_ROUTER`: specifies the routing engine to be used, `osrm`, `valhalla` or `ors`. Default `osrm`.\n\nThe pre-configured host for the routing servers is `localhost` and `port: 8080` for ORS, `port: 5000` for OSRM and `port: 8002` for Valhalla.\n\n\u003e **Note**, the environment variable `VROOM_ROUTER` has precedence over the `router` setting in `config.yml`.\n\n### Volume mounting\n\nAll relevant files are located inside the container's `/conf` directory and can be shared with the host. These include:\n\n- `access.log`: the server log for `vroom-express`\n- `config.yml`: the server configuration file, which gives you full control over the `vroom-express` configuration. If you need to edit the configuration, run `docker restart vroom` to restart the server with the new settings.\n\nAdd a `-v $PWD/vroom-conf:/conf` to your `docker run` command.\n\n### Build arguments\n\nIf you prefer to build the image from source, there are 2 build arguments:\n\n- `VROOM_RELEASE`: specifies VROOM's git [branch](https://github.com/VROOM-Project/vroom/branches), [commit hash](https://github.com/VROOM-Project/vroom/commits/master) or [release](https://github.com/VROOM-Project/vroom/releases) (e.g. `v1.14.0`) to install in the container\n- `VROOM_EXPRESS_RELEASE`: specifies `vroom-express`'s git [branch](https://github.com/VROOM-Project/vroom-express/branches), [commit hash](https://github.com/VROOM-Project/vroom-express/commits/master) or [release](https://github.com/VROOM-Project/vroom-express/releases) (e.g. `v0.12.0`) to install in the container\n\n\u003e **Note**, not all versions are compatible with each other\n\n## Routing Server\n\nYou have the option to use [OSRM](https://github.com/Project-OSRM/osrm-backend), [Valhalla](https://github.com/valhalla/valhalla) or [OpenRouteService](https://github.com/GIScience/openrouteservice). However, the proper setup in Docker or `docker-compose` depends on how you run the routing server.\n\n### Routing server in local Docker container\n\nIf you started the routing layer in a separate Docker container via `docker run` and didn't create a docker network, you'll have to start the `vroom` container on the `host` network by adding `--net host`. The disadvantage is that you'll have to assign `vroom-express` configured `port` on the host machine. If port 3000 is already occupied on your machine, configure a different port in `config.yml`.\n\nAlternatively you can add both containers to a private Docker network and change the routing server host(s) to the routing server container name(s) in `config.yml` before restarting the `vroom` container. However, the concepts involved are beyond the scope of this project.\n\n### Routing server on a remote server\n\nIn this case, you'll have to edit the mapped `config.yml` to include the host and port you published the routing server on.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvroom-project%2Fvroom-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvroom-project%2Fvroom-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvroom-project%2Fvroom-docker/lists"}