readme-vars.yml

---

# project information
project_name: minetest
project_url: "http://www.minetest.net/"
project_logo: "https://raw.githubusercontent.com/linuxserver/beta-templates/master/lsiodev/img/minetest-icon.png"
project_blurb: "[{{ project_name|capitalize }}]({{ project_url }}) (server) is a near-infinite-world block sandbox game and a game engine, inspired by InfiniMiner, Minecraft, and the like."
project_lsio_github_repo_url: "https://github.com/linuxserver/docker-{{ project_name }}"
project_blurb_optional_extras_enabled: false
# supported architectures
available_architectures:
  - {arch: "{{ arch_x86_64 }}", tag: "amd64-latest"}
  - {arch: "{{ arch_arm64 }}", tag: "arm64v8-latest"}
# container parameters
common_param_env_vars_enabled: true
param_container_name: "{{ project_name }}"
param_usage_include_vols: true
param_volumes:
  - {vol_path: "/config/.minetest", vol_host_path: "/path/to/{{ project_name }}/data", desc: "Where minetest stores config files and maps etc."}
param_usage_include_ports: true
param_ports:
  - {external_port: "30000", internal_port: "30000/udp", port_desc: "Port Minetest listens on (UDP)."}
# optional container parameters
opt_param_usage_include_env: true
opt_param_env_vars:
  - {env_var: "CLI_ARGS", env_value: "--gameid devtest", desc: "Optionally specify any [CLI variables](https://wiki.minetest.net/Command_line) you want to launch the app with"}
# application setup block
app_setup_block_enabled: true
app_setup_block: |
  You can find the world maps, mods folder and config files in /config/.minetest.

  If you want to override the advertised port, ensure you add --port in your CLI_ARGS AND ensure the internal port reflects the change, ie;
  if you set your advertised port to 40000 with --port 40000 then your ports declaration should be 40000:40000/udp

  Client and server must be the same version, please browse the tags here to pull the appropriate version for your server:

  https://hub.docker.com/r/linuxserver/{{ project_name }}/tags

  ### Bundled Games

  As per [upstream request](https://github.com/minetest/minetest/releases/tag/5.8.0) this image no longer includes [minetest_game](https://github.com/minetest/minetest_game), so if required you will need to either install via ContentDB or download it from their repo and copy to `/config/.minetest/games/minetest`
# init diagram
init_diagram: |
  "minetest:latest": {
    docker-mods
    base {
      fix-attr +\nlegacy cont-init
    }
    docker-mods -> base
    legacy-services
    custom services
    init-services -> legacy-services
    init-services -> custom services
    custom services -> legacy-services
    legacy-services -> ci-service-check
    init-migrations -> init-adduser
    init-os-end -> init-config
    init-config -> init-config-end
    init-minetest-config -> init-config-end
    init-os-end -> init-crontab-config
    init-mods-end -> init-custom-files
    base -> init-envfile
    base -> init-migrations
    init-config -> init-minetest-config
    base -> init-mods
    init-config-end -> init-mods
    init-mods -> init-mods-end
    init-mods-package-install -> init-mods-end
    init-mods -> init-mods-package-install
    base -> init-os-end
    init-adduser -> init-os-end
    init-envfile -> init-os-end
    init-migrations -> init-os-end
    init-custom-files -> init-services
    init-mods-end -> init-services
    init-services -> svc-cron
    svc-cron -> legacy-services
    init-services -> svc-minetest
    svc-minetest -> legacy-services
  }
  Base Images: {
    "baseimage-alpine:3.20"
  }
  "minetest:latest" <- Base Images
# changelog
changelogs:
  - {date: "25.11.24:", desc: "Add Prometheus metrics support."}
  - {date: "01.06.24:", desc: "Rebase to Alpine 3.20."}
  - {date: "12.05.24:", desc: "Unpin irrlicht, enable IPv6 support in default conf."}
  - {date: "10.05.24:", desc: "Enable PostgreSQL backend and fix libspatialindex branch name."}
  - {date: "26.01.24:", desc: "Temporarily pin irrlicht to continue building pending a bugfix release."}
  - {date: "23.12.23:", desc: "Rebase to Alpine 3.19."}
  - {date: "12.07.23:", desc: "Rebase to Alpine 3.18, remove minetest_game."}
  - {date: "06.07.23:", desc: "Deprecate armhf. As announced [here](https://www.linuxserver.io/blog/a-farewell-to-arm-hf)"}
  - {date: "09.04.23:", desc: "Build logic changes to copy devtest to default games."}
  - {date: "17.03.23:", desc: "Fix CLI_ARGS example in readme."}
  - {date: "23.02.23:", desc: "Rebase to Alpine 3.17, migrate to s6v3."}
  - {date: "06.08.22:", desc: "Update irrlicht deps."}
  - {date: "02.05.22:", desc: "Allow specifying the advertised port."}
  - {date: "17.03.22:", desc: "Install forked irrlicht, add zstd."}
  - {date: "19.01.22:", desc: "Rebasing to alpine 3.15."}
  - {date: "02.06.20:", desc: "Rebasing to alpine 3.12."}
  - {date: "19.12.19:", desc: "Rebasing to alpine 3.11."}
  - {date: "12.07.19:", desc: "Bugfix to support multiple CLI variables."}
  - {date: "28.06.19:", desc: "Rebasing to alpine 3.10."}
  - {date: "03.06.19:", desc: "Adding custom cli vars to options."}
  - {date: "23.03.19:", desc: "Switching to new Base images, shift to arm32v7 tag."}
  - {date: "04.03.19:", desc: "Rebase to alpine 3.9 to compile 5.0.0 minetest with new build args."}
  - {date: "14.01.19:", desc: "Add pipeline logic and multi arch."}
  - {date: "08.08.18:", desc: "Rebase to alpine 3.8, build from latest release tag instead of master."}
  - {date: "03.01.18:", desc: "Deprecate cpu_core routine lack of scaling."}
  - {date: "08.12.17:", desc: "Rebase to alpine 3.7."}
  - {date: "30.11.17:", desc: "Use cpu core counting routine to speed up build time."}
  - {date: "26.05.17:", desc: "Rebase to alpine 3.6."}
  - {date: "14.02.17:", desc: "Rebase to alpine 3.5."}
  - {date: "25.11.16:", desc: "Rebase to alpine linux, move to main repo."}
  - {date: "27.02.16:", desc: "Bump to latest version."}
  - {date: "19.02.16:", desc: "Change port to UDP, thanks to slashopt for pointing this out."}
  - {date: "15.02.16:", desc: "Make minetest app a service."}
  - {date: "01.02.16:", desc: "Add lua-socket dependency."}
  - {date: "06.11.15:", desc: "Initial Release."}