{"id":18855851,"url":"https://github.com/flobernd/docker-minecraft-ftb","last_synced_at":"2025-09-03T16:32:59.042Z","repository":{"id":231386928,"uuid":"777810511","full_name":"flobernd/docker-minecraft-ftb","owner":"flobernd","description":"A Docker image developed to launch Minecraft FTB Modpack servers as safely, quickly and easily as possible.","archived":false,"fork":false,"pushed_at":"2024-12-29T20:32:39.000Z","size":21,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-29T21:24:14.822Z","etag":null,"topics":["docker","feed-the-beast","ftb","ftb-minecraft-server","minecraft","minecraft-server"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flobernd.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}},"created_at":"2024-03-26T14:45:21.000Z","updated_at":"2024-12-29T20:32:01.000Z","dependencies_parsed_at":"2024-04-03T21:26:54.007Z","dependency_job_id":"78a4e62d-b607-44e2-9f23-0e5234b81c98","html_url":"https://github.com/flobernd/docker-minecraft-ftb","commit_stats":null,"previous_names":["flobernd/docker-minecraft-ftb"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flobernd%2Fdocker-minecraft-ftb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flobernd%2Fdocker-minecraft-ftb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flobernd%2Fdocker-minecraft-ftb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flobernd%2Fdocker-minecraft-ftb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flobernd","download_url":"https://codeload.github.com/flobernd/docker-minecraft-ftb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231903403,"owners_count":18443523,"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":["docker","feed-the-beast","ftb","ftb-minecraft-server","minecraft","minecraft-server"],"created_at":"2024-11-08T03:56:32.843Z","updated_at":"2025-09-03T16:32:59.032Z","avatar_url":"https://github.com/flobernd.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Minecraft FTB\n\nA Docker image developed to launch Minecraft [FTB](https://www.feed-the-beast.com/) Modpack servers as safely, quickly and easily as\npossible.\n\n## Features\n\n- Supports all \"Feed The Beast\" (FTB) [modpacks](https://www.feed-the-beast.com/modpacks?sort=featured)\n- Configurable modpack versions\n  - Allows pinning to a specific modpack version (see `FTB_MODPACK_VERSION_ID`)\n  - Installs the latest version of the modpack, if no specific version is configured\n- Supports automatic modpack upgrades on container start (see `AUTO_UPDATE`)\n- Supports unattended installation (see `ACCEPT_MOJANG_EULA`)\n- Supports configuration of user-defined JVM arguments as part of the container configuration (see `USER_JVM_ARGS`)\n- Drops `root` privileges after setting up the container and runs the server as an unprivileged user\n  - Allows to customize the internal user (see `GID`/`UID`)\n- Multi architecture support (`x86-64`/`amd64`, `aarch64`/`arm64`)\n\n![Screenshot](./screenshot.png)\n\n## Example\n\n```bash\ndocker run -itd --name minecraft-ftb \\\n    -v \"/docker_data/minecraft:/var/lib/minecraft\" \\\n    -e \"FTB_MODPACK_ID=126\" \\\n    -e \"ACCEPT_MOJANG_EULA=1\" \\\n    -e \"USER_JVM_ARGS=-Xms1G -Xmx4G\" \\\n    -p \"25565:25565\" \\\n    --stop-timeout=60 \\\n    ghcr.io/flobernd/minecraft-ftb\n```\n\n## Docker Compose Example\n\n```yaml\nservices:\n  minecraft-ftb:\n    image: ghcr.io/flobernd/minecraft-ftb:latest\n    container_name: minecraft-ftb\n    restart: unless-stopped\n    tty: true\n    stdin_open: true\n    stop_grace_period: 1m\n    environment:\n      FTB_MODPACK_ID: 126\n      ACCEPT_MOJANG_EULA: 1\n      USER_JVM_ARGS: \"-Xms1G -Xmx4G\"\n    volumes:\n      - ./minecraft:/var/lib/minecraft:rw\n    ports:\n      - 25565:25565\n```\n\n## Notes\n\n\u003e [!WARNING]\n\u003e The server process does not shut down gracefully, if no TTY is present. Please pass the `--tty`/`-t` switch (Docker) or use `tty: true`\n\u003e (Docker Compose).\n\n\u003e [!WARNING]\n\u003e It is strongly recommended to set the `stop-timeout` (Docker) / `stop_grace_period` (Docker Compose) to at least `60` seconds to avoid\n\u003e data loss when stopping the container.\n\n\u003e [!NOTE]\n\u003e It is recommended to pass the `--interactive`/`-i` switch (Docker) or use `stdin_open: true` (Docker Compose) to be able to use the\n\u003e server console after attaching to the container.\n\n## Environment\n\n### `FTB_MODPACK_ID`\n\nThe FTB modpack ID (*required*).\n\n\u003e [!NOTE]\n\u003e The modpack ID and the version ID are displayed on the right-hand side of the modpack info page. For example, the\n\u003e [Direwolf20 1.21 modpack](https://www.feed-the-beast.com/modpacks/126-ftb-presents-direwolf20-121) has the ID `126` and the latest\n\u003e version, as of today, is `12599`.\n\n### `FTB_MODPACK_VERSION_ID`\n\nThe FTB modpack version ID.\n\n\u003e [!NOTE]\n\u003e If the configured version is lower than the version already installed, the container will fail to start with an error.\n\nDefault: Latest version of the configured modpack.\n\n### `ACCEPT_MOJANG_EULA`\n\nSet `1` to automatically agree to the [Mojang EULA](https://account.mojang.com/documents/minecraft_eula).\n\nThis option enables unattended installation. Otherwise, an interactive session must be used to accept the EULA after installation, or the\n`eula.txt` must be edited manually and the container restarted.\n\nDefault: `0`.\n\n### `USER_JVM_ARGS`\n\nOptional, user-defined JVM arguments.\n\nUse the `-Xms` switch to configure the minimum amount of memory used by the JVM. `-Xms1G` sets the minimum amount of memory to 1 GB.\nThe `M` suffix can be used to specify the amount of memory in megabytes instead of gigabytes.\n\nUse the `-Xmx` switch to configure the maximum amount of memory used by the JVM. `-Xms4G` sets the maximum amount of memory to 4 GB.\nThe `M` suffix can be used to specify the amount of memory in megabytes instead of gigabytes.\n\nTo specify multiple arguments, combine them with spaces: `-Xms1G -Xmx4G`.\n\n\u003e [!WARNING]\n\u003e Using this option causes the `user_jvm_args.txt` file to be overwritten when the container is started.\n\nDefault: *none*\n\n### `AUTO_UPDATE`\n\nSet `1` to automatically update the modpack when the container is started.\n\nIf `FTB_MODPACK_VERSION_ID` is set, the configured version number is used, otherwise the latest version of the modpack is determined\nautomatically.\n\nDefault: `0`\n\n### `FORCE_REINSTALL`\n\nSet `1` to force a reinstallation of the modpack when the container is started.\n\n\u003e [!WARNING]\n\u003e This option should only be used in special cases, as constantly reinstalling the modpack significantly slows down the start of the\n\u003e container.\n\nDefault: `0`\n\n### `GID`\n\nThe `GID` of the internal `minecraft` group.\n\nDefault: `99`\n\n### `UID`\n\nThe `UID` of the internal `minecraft` user.\n\nDefault: `99`\n\n## License\n\nDocker Minecraft FTB is licensed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflobernd%2Fdocker-minecraft-ftb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflobernd%2Fdocker-minecraft-ftb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflobernd%2Fdocker-minecraft-ftb/lists"}