Environment Variables

Core Variables

• DATA_DIR

  • Description: The root directory where templates, runtime, and .cache folders are mapped inside the container.
  • Default: /data

• VERBOSE

  • Description: Enables verbose debug log output from the Python orchestrator script.
  • Default: false

• ACCEPT_EULA

  • Description: Most Minecraft backend servers require EULA acceptance. Set this to true to automatically write the eula.txt.
  • Default: false

• TYPE

  • Description: The platform software to run. This determines which variables (like VERSION or MEMORY) are available and how they behave. See Server Platforms for details.
  • Default: PAPER

• PLUGINS_UPDATE_STRATEGY

  • Description: Controls how the orchestrator handles plugin updates on startup.
  • Options:
    • manual: Checks for updates and removes orphans, but never downloads anything.
    • auto: (Default) Downloads updates and removes orphans; continues on download failure.
    • force: Downloads updates and removes orphans; fails on any download failure.
  • Default: auto

• PLUGINS_CHECK_CACHE

  • Description: Defines how long plugin update-checks are considered fresh. When set, the orchestrator will skip re-checking (and re-downloading) already-installed plugins if the last full check happened within this window. New plugins are always downloaded and obsolete plugins are always removed, regardless of this setting. This is useful during development to avoid hammering provider APIs when restarting the server frequently.
  • Format: A number followed by a unit — s (seconds), m (minutes), h (hours), or d (days). Examples: 30s, 5m, 2h.
  • Default: 5m

RCON Variables

If RCON is enabled, the orchestrator automatically configures the server files to expose RCON.

• RCON_ENABLED

  • Description: Toggles the automatic RCON injection process.
  • Default: true

• RCON_PORT

  • Description: The local port mapped for RCON inside the container.
  • Default: 25575

• RCON_PASSWORD

  • Description: The password for RCON.
  • Default: A securely generated random UUID (uuid.uuid4()). You do not need to know this password to use mc-rcon interactively inside the container.