{"id":31223646,"url":"https://github.com/gama-platform/gama.docker","last_synced_at":"2026-05-16T11:33:17.017Z","repository":{"id":56235693,"uuid":"209849500","full_name":"gama-platform/gama.docker","owner":"gama-platform","description":"⛴ Docker image of GAMA headless","archived":false,"fork":false,"pushed_at":"2026-04-09T05:56:45.000Z","size":118,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":8,"default_branch":"master","last_synced_at":"2026-04-09T07:36:40.509Z","etag":null,"topics":["docker","docker-image","dockerfile","gama","gama-platform","headless"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/gamaplatform/gama","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/gama-platform.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":"2019-09-20T17:49:36.000Z","updated_at":"2026-04-09T05:56:50.000Z","dependencies_parsed_at":"2024-01-01T01:30:53.419Z","dependency_job_id":"ccecc47a-7263-4839-85a4-b03e2986946f","html_url":"https://github.com/gama-platform/gama.docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gama-platform/gama.docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gama-platform%2Fgama.docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gama-platform%2Fgama.docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gama-platform%2Fgama.docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gama-platform%2Fgama.docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gama-platform","download_url":"https://codeload.github.com/gama-platform/gama.docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gama-platform%2Fgama.docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33100864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["docker","docker-image","dockerfile","gama","gama-platform","headless"],"created_at":"2025-09-21T22:51:30.273Z","updated_at":"2026-05-16T11:33:17.011Z","avatar_url":"https://github.com/gama-platform.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GAMA Docker Container\n\nThis project is a simple Docker image that contains a GAMA platform ready to use in headless mode within a minimal [Alpine](https://alpinelinux.org/) with [Eclipse Adoptium OpenJDK 21 64-Bit Server VM](https://adoptium.net/temurin/releases/) container.\n\n## Getting Started\n\nThese instructions will cover usage information and for the docker container \n\n### Prerequisities\n\n\nIn order to run this container you'll need to install [docker](https://docs.docker.com/get-started/get-docker/).\n\n### Usage\n\n#### Tags\n\nThe [GAMA Platform Docker repository](https://hub.docker.com/r/gamaplatform/gama) does contain a lot of different versions of GAMA :\n\n- **Stable releases** \n  - starting from [1.8 Release Candidate 2](https://hub.docker.com/layers/gamaplatform/gama/1.8-rc2/images/sha256-76035a577c8541ca6610a949cc58a4e76a7423da2e89c140a67cd75ae3e29efc?context=explore)\n- **Rolling releases** \n  - [_alpha_](https://hub.docker.com/layers/gamaplatform/gama/alpha/images/sha256-f381dcea8d1f7dac3bb18752a5ce263c32a0e90474dc14b8799d73a320d5f67c?context=explore) which is the latest build done with current github code. This is not tested contrary to official releases.\n- **Meta tags**\n  - [_latest_](https://hub.docker.com/layers/gamaplatform/gama/latest/images/sha256-15746fa81624c38b085d891e521fb4fe737f06b3a1f6a955dc53b4d5558ad46f?context=explore) which is the latest official release\n\n#### Simple usage\n\nThe command to run the previously builded image is simple as below\n\n```\ndocker run gamaplatform/gama:latest \u003ccustom argument for headless execution\u003e\n```\n\nBy default, if you don't add argument after the container image, it will display the help message.\n\n#### Shutdown the container\n\nThe container will stop automatically when the headless run will end.\n\n#### Enter in the container\n\nIf you want to enter in bash inside the gama container, you will have to explicitly change the _Docker Entrypoint_ of the container by this way\n\n```\ndocker run -i -t --entrypoint /bin/bash \u003ccontainerID\u003e\n```\n\n### Example\n\n```\n$ docker run --rm gamaplatform/gama:1.8.1 -help\ngama-headless.sh\n******************************************************************\n* GAMA version 1.8.1                                             *\n* http://gama-platform.org                                       *\n* (c) 2007-2019 UMI 209 UMMISCO IRD/SU \u0026 Partners                *\n******************************************************************\n Welcome to Gama-platform.org version GAMA 1.8.1\nsh ./gama-headless.sh [Options] [XML Input] [output directory]\n\nList of available options:\n      -help                   -- get the help of the command line\n      -version                -- get the the version of gama\n      -m [mem]                -- allocate memory (ex 2048m)\n      -c                      -- start the console to write xml parameter file\n      -v                      -- verbose mode\n      -hpc [core]             -- set the number of core available for experimentation\n      -socket [socketPort]    -- start socket pipeline to interact with another framework\n      -p                      -- start pipeline to interact with another framework\n      -validate [directory]   -- invokes GAMA to validate the models present in the directory passed as argument\n      -test [directory]       -- invokes GAMA to execute the tests present in the directory and display their results\n      -failed                 -- only display the failed and aborted test results\n      -xml [experimentName] [modelFile.gaml] [xmlOutputFile.xml] -- only display the failed and aborted test results\n sh ./gama-headless.sh -xml experimentName gamlFile xmlOutputFile\n\n      build an xml parameter file from a model\n```\n\n#### Environment Variables\n\n* `/usr/lib/gama/headless/gama-headless.sh` - Headless launch script (Default `Entrypoint`)\n\n#### Useful File Locations\n\n* `/opt/gama-platform` - The installed version of [GAMA](http://gama-platform.org)\n\n* `/opt/gama-platform/headless/gama-platform.sh` - The helping file to launch [GAMA Headless](https://gama-platform.org/wiki/RunningHeadless)\n\n### Installing\n\n#### Docker Hub pull\n\n```shell\n$ docker pull gamaplatform/gama:[latest|1.8.1|..]\n```\n\nTo see all the available tags, see [there](https://hub.docker.com/r/gamaplatform/gama/tags).\n\n#### Building\n\nClone this repository\n\n```\ngit clone https://github.com/gama-platform/gama.docker\n```\n\nMove in the cloned repository\n\n```\ncd ./gama.docker/tags/\u003cany-tag-name\u003e\n```\n\nBuild the Docker image\n\n```\ndocker build -t gama .\n```\n## Docker compose \n```\nservices:\n  gama:\n    image: gamaplatform/gama:alpha\n    # Modify here the command to be run by the container upon execution\n    command: gama-headless -v /opt/gama-platform/headless/samples/roadTraffic.xml /opt/gama-platform/output\n    container_name: gama_container\n    # Map the outputs of the execution to a local \"output\" directory\n    volumes: \n      - ./output:/opt/gama-platform/output\n    restart: no\n```\nYou can run the following to execute the example docker compose file :\n```\n$ docker compose up -d\n```\nIf you want to run your own model inside the container, map it to volumes inside the container :\n```\nservices:\n  gama:\n    image: gamaplatform/gama:alpha\n    command: gama-headless -v /opt/gama-platform/headless/your_model/ExperimentFile.xml /opt/gama-platform/output\n    container_name: gama_container\n    volumes: \n      - ./output:/opt/gama-platform/output\n      - /path/to/your_model:/opt/gama-platform/headless/your_model\n    restart: no\n```\n## Built With\n\n* GAMA-Platform - https://github.com/gama-platform/gama/releases/\n* Docker - https://docker.com\n* AlpineOS - https://alpinelinux.org/\n* OpenJDK 17 - https://openjdk.java.net/\n\n## Find Us\n\n* [GitHub](https://github.com/gama-platform)\n* [Docker Hub](https://hub.docker.com/r/gamaplatform/gama)\n* [GAMA-Platform](https://gama-platform.github.io/)\n\n\u003c!--\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.\n--\u003e\n\n# Authors\n\n* **Arthur Brugiere** - [RoiArthurB](https://github.com/RoiArthurB)\n\nSee also the list of [contributors](https://github.com/gama-platform/gama.docker/contributors) who participated in this project.\n\n# License\n\nThis project is licensed under the GPL3 License - see the [LICENSE.md](LICENSE.md) file for details\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgama-platform%2Fgama.docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgama-platform%2Fgama.docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgama-platform%2Fgama.docker/lists"}