Minecraft Bedrock
Get Started with Apps!
Keywords: world, building
Train: Community
Home Page: https://www.minecraft.net/en-us
Added: 2025-01-15
Last Updated: 2025-09-02
Minecraft dedicated server for Bedrock platform hosts a world for multiplayer game. Players can join the server using the Bedrock client on Desktops, Mobiles, and consoles.
Run as Context- Minecraft runs as any non-root user.
Group: 568 / minecraft
User: 568 / minecraft
App Metadata (Raw File)
{
"1.0.27": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/minecraft-bedrock/1.0.27",
"last_update": "2025-09-02 15:29:51",
"required_features": [],
"human_version": "2025.9.0_1.0.27",
"version": "1.0.27",
"app_metadata": {
"app_version": "2025.9.0",
"capabilities": [],
"categories": [
"games"
],
"changelog_url": "https://github.com/itzg/docker-minecraft-bedrock-server/releases",
"date_added": "2025-01-15",
"description": "Minecraft dedicated server for Bedrock platform hosts a world for multiplayer game.\nPlayers can join the server using the Bedrock client on Desktops, Mobiles, and consoles.\n",
"home": "https://www.minecraft.net/en-us",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/minecraft-bedrock/icons/icon.svg",
"keywords": [
"world",
"building"
],
"lib_version": "2.1.49",
"lib_version_hash": "e71e6b0122c9446fa5ea6fb07e7eb01b11fb42d549a19845426bbd7e21a42634",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "minecraft-bedrock",
"run_as_context": [
{
"description": "Minecraft runs as any non-root user.",
"gid": 568,
"group_name": "minecraft",
"uid": 568,
"user_name": "minecraft"
}
],
"screenshots": [],
"sources": [
"https://www.minecraft.net/en-us",
"https://github.com/itzg/docker-minecraft-bedrock-server"
],
"title": "Minecraft Server (Bedrock)",
"train": "community",
"version": "1.0.27"
},
"schema": {
"groups": [
{
"name": "Minecraft Bedrock Configuration",
"description": "Configure Minecraft Bedrock"
},
{
"name": "User and Group Configuration",
"description": "Configure User and Group for Minecraft Bedrock"
},
{
"name": "Network Configuration",
"description": "Configure Network for Minecraft Bedrock"
},
{
"name": "Storage Configuration",
"description": "Configure Storage for Minecraft Bedrock"
},
{
"name": "Labels Configuration",
"description": "Configure Labels for Minecraft Bedrock"
},
{
"name": "Resources Configuration",
"description": "Configure Resources for Minecraft Bedrock"
}
],
"questions": [
{
"variable": "TZ",
"group": "Minecraft Bedrock Configuration",
"label": "Timezone",
"schema": {
"type": "string",
"default": "Etc/UTC",
"required": true,
"$ref": [
"definitions/timezone"
]
}
},
{
"variable": "minecraft_bedrock",
"label": "",
"group": "Minecraft Bedrock Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "eula",
"label": "EULA",
"description": "The end user license agreement for Minecraft Bedrock. </br>\nhttps://www.minecraft.net/en-us/eula\nMust be checked...\n",
"schema": {
"type": "boolean",
"default": false,
"required": true
}
},
{
"variable": "version",
"label": "Version",
"description": "Version of the minecraft server to load on startup : </br>\nLATEST : determines the latest version (can be used to auto-upgrade on start). </br>\nPREVIOUS : uses the previously maintained major version. (Useful when the mobile app is gradually being upgraded across devices.) </br>\notherwise any specific server version can be provided to allow for temporary bug avoidance, etc. </br>\nhttps://github.com/truenas/apps/issues/1641\n",
"schema": {
"type": "string",
"default": "LATEST",
"required": true
}
},
{
"variable": "server_name",
"label": "Server Name",
"schema": {
"type": "string",
"default": "Minecraft Bedrock Server",
"required": true
}
},
{
"variable": "level_name",
"label": "Level Name",
"description": "The name of which level used/generated. Each level has its own folder in /worlds.",
"schema": {
"type": "string",
"default": "Bedrock level",
"valid_chars": "^[^\\n\\r\\t\\f`?*\\<>|\"':]+$",
"valid_chars_error": "Cannot contain illegal filename characters: /\\n\\r\\t\\f`?*\\\\<>|\\\":\n",
"required": true
}
},
{
"variable": "level_type",
"label": "Level Type",
"description": "Type of generation for the world. </br>\nOnly used on world creation during install. </br>\nhttps://minecraft.fandom.com/wiki/Server.properties#Option_keys -> level-type\n",
"schema": {
"type": "string",
"default": "DEFAULT",
"required": true,
"enum": [
{
"value": "DEFAULT",
"description": "Default"
},
{
"value": "FLAT",
"description": "Flat"
},
{
"value": "LEGACY",
"description": "Legacy"
}
]
}
},
{
"variable": "level_seed",
"label": "Level Seed",
"description": "The seed for the world generator in the Minecraft Bedrock server.</br>\nIf left empty, a seed is chosen at random. </br>\nOnly used on world creation during install. </br>\nhttps://minecraft.fandom.com/wiki/Server.properties#Option_keys -> seed\n",
"schema": {
"type": "string",
"default": ""
}
},
{
"variable": "game_mode",
"label": "Game Mode",
"schema": {
"type": "string",
"default": "survival",
"required": true,
"enum": [
{
"value": "survival",
"description": "Survival"
},
{
"value": "creative",
"description": "Creative"
},
{
"value": "adventure",
"description": "Adventure"
}
]
}
},
{
"variable": "force_game_mode",
"label": "Force Game Mode",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "difficulty",
"label": "Difficulty",
"schema": {
"type": "string",
"default": "easy",
"required": true,
"enum": [
{
"value": "peaceful",
"description": "Peaceful"
},
{
"value": "easy",
"description": "Easy"
},
{
"value": "normal",
"description": "Normal"
},
{
"value": "hard",
"description": "Hard"
}
]
}
},
{
"variable": "allow_cheats",
"label": "Allow Cheats",
"description": "Allow usage of cheat like commands within game. </br>\nhttps://minecraft.fandom.com/wiki/Commands#List_and_summary_of_commands\n",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "view_distance",
"label": "View Distance",
"schema": {
"type": "int",
"default": 32,
"min": 5,
"required": true
}
},
{
"variable": "tick_distance",
"label": "Tick Distance",
"schema": {
"type": "int",
"default": 4,
"min": 4,
"max": 12,
"required": true
}
},
{
"variable": "emit_server_telemetry",
"label": "Emit Server Telemetry",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "texture_pack_required",
"label": "Texture Pack Required",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "enable_lan_visibility",
"label": "Enable LAN Visibility",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "online_mode",
"label": "Online Mode",
"description": "Enable online mode. </br>\nWhen enabled, all connected players must be authenticated to Xbox Live. </br>\nhttps://minecraft.fandom.com/wiki/Server.properties#Option_keys -> Online Mode\n",
"schema": {
"type": "boolean",
"default": true
}
},
{
"variable": "max_players",
"label": "Max Players Number",
"description": "Maximum number of player that can be connected at the same Time. </br>\nhttps://minecraft.fandom.com/wiki/Server.properties#Option_keys -> max-players\n",
"schema": {
"type": "int",
"default": 10,
"min": 1,
"required": true
}
},
{
"variable": "player_idle_timeout",
"label": "Player Idle Timeout",
"description": "Number of minutes a player can be idle before being kicked from the server.</br>\n0 to disable. </br>\nhttps://minecraft.fandom.com/wiki/Server.properties#Option_keys -> player-idle-timeout\n",
"schema": {
"type": "int",
"default": 30,
"min": 0,
"required": true
}
},
{
"variable": "default_player_permission_level",
"label": "Default Player Permission Level",
"description": "Permission level for new players joining for the first time. </br>\nhttps://minecraft.fandom.com/wiki/Server.properties#Option_keys -> default-player-permission-level\n",
"schema": {
"type": "string",
"default": "member",
"required": true,
"enum": [
{
"value": "visitor",
"description": "Visitor"
},
{
"value": "member",
"description": "Member"
},
{
"value": "operator",
"description": "Operator"
}
]
}
},
{
"variable": "ops",
"label": "Operators",
"description": "Sets operator permissions for listed players.</br>\nOperator can use commands. </br>\nhttps://hub.docker.com/r/itzg/minecraft-bedrock-server -> Permissions</br>\nOne XUID per field. (Xbox User ID can be found at https://www.cxkes.me/xbox/xuid)\n",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "op",
"label": "Op",
"schema": {
"type": "string",
"default": "",
"required": true
}
}
]
}
},
{
"variable": "members",
"label": "Members",
"description": "Sets member permissions for listed players.</br>\nhttps://hub.docker.com/r/itzg/minecraft-bedrock-server -> Permissions </br>\nOne XUID per field. (Xbox User ID can be found at https://www.cxkes.me/xbox/xuid)\n",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "member",
"label": "Member",
"schema": {
"type": "string",
"default": "",
"required": true
}
}
]
}
},
{
"variable": "visitors",
"label": "Visitors",
"description": "Sets visitor permissions for listed players. </br>\nhttps://hub.docker.com/r/itzg/minecraft-bedrock-server -> Permissions </br>\nOne XUID per field. (Xbox User ID can be found at https://www.cxkes.me/xbox/xuid)\n",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "visitor",
"label": "Visitor",
"schema": {
"type": "string",
"default": "",
"required": true
}
}
]
}
},
{
"variable": "allow_list_users",
"label": "Allow List Users",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "allow_list_user",
"label": "Allow List User",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "name",
"label": "Name",
"schema": {
"type": "string",
"default": "",
"required": true
}
},
{
"variable": "uuid",
"label": "UUID",
"schema": {
"type": "string",
"default": "",
"required": true
}
}
]
}
}
]
}
},
{
"variable": "additional_envs",
"label": "Additional Environment Variables",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "env",
"label": "Environment Variable",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "name",
"label": "Name",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "value",
"label": "Value",
"schema": {
"type": "string"
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "run_as",
"label": "",
"group": "User and Group Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "user",
"label": "User ID",
"description": "The user id that Minecraft Bedrock files will be owned by.",
"schema": {
"type": "int",
"min": 568,
"default": 568,
"required": true
}
},
{
"variable": "group",
"label": "Group ID",
"description": "The group id that Minecraft Bedrock files will be owned by.",
"schema": {
"type": "int",
"min": 568,
"default": 568,
"required": true
}
}
]
}
},
{
"variable": "network",
"label": "",
"group": "Network Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "server_port",
"label": "Server Port",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "bind_mode",
"label": "Port Bind Mode",
"description": "The port bind mode.</br>\n- Publish: The port will be published on the host for external access.</br>\n- Expose: The port will be exposed for inter-container communication.</br>\n- None: The port will not be exposed or published.</br>\nNote: If the Dockerfile defines an EXPOSE directive,\nthe port will still be exposed for inter-container communication regardless of this setting.\n",
"schema": {
"type": "string",
"default": "published",
"enum": [
{
"value": "published",
"description": "Publish port on the host for external access"
},
{
"value": "exposed",
"description": "Expose port for inter-container communication"
},
{
"value": "",
"description": "None"
}
]
}
},
{
"variable": "port_number",
"label": "Port Number",
"schema": {
"type": "int",
"default": 19132,
"min": 1,
"max": 65535,
"required": true
}
},
{
"variable": "host_ips",
"label": "Host IPs",
"description": "IPs on the host to bind this port",
"schema": {
"type": "list",
"show_if": [
[
"bind_mode",
"=",
"published"
]
],
"default": [],
"items": [
{
"variable": "host_ip",
"label": "Host IP",
"schema": {
"type": "string",
"required": true,
"$ref": [
"definitions/node_bind_ip"
]
}
}
]
}
}
]
}
},
{
"variable": "host_network",
"label": "Host Network",
"description": "Bind to the host network. It's recommended to keep this disabled.\n",
"schema": {
"type": "boolean",
"default": false
}
}
]
}
},
{
"variable": "storage",
"label": "",
"group": "Storage Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "data",
"label": "Minecraft Bedrock Data Storage",
"description": "The path to store Minecraft Bedrock Data.",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "type",
"label": "Type",
"description": "ixVolume: Is dataset created automatically by the system.</br>\nHost Path: Is a path that already exists on the system.\n",
"schema": {
"type": "string",
"required": true,
"default": "ix_volume",
"enum": [
{
"value": "host_path",
"description": "Host Path (Path that already exists on the system)"
},
{
"value": "ix_volume",
"description": "ixVolume (Dataset created automatically by the system)"
}
]
}
},
{
"variable": "ix_volume_config",
"label": "ixVolume Configuration",
"description": "The configuration for the ixVolume dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"ix_volume"
]
],
"$ref": [
"normalize/ix_volume"
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "dataset_name",
"label": "Dataset Name",
"description": "The name of the dataset to use for storage.",
"schema": {
"type": "string",
"required": true,
"hidden": true,
"default": "data"
}
},
{
"variable": "acl_entries",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": []
}
}
]
}
},
{
"variable": "host_path_config",
"label": "Host Path Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"host_path"
]
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "acl",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": [],
"$ref": [
"normalize/acl"
]
}
},
{
"variable": "path",
"label": "Host Path",
"description": "The host path to use for storage.",
"schema": {
"type": "hostpath",
"show_if": [
[
"acl_enable",
"=",
false
]
],
"required": true
}
}
]
}
}
]
}
},
{
"variable": "additional_storage",
"label": "Additional Storage",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "storageEntry",
"label": "Storage Entry",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "type",
"label": "Type",
"description": "ixVolume: Is dataset created automatically by the system.</br>\nHost Path: Is a path that already exists on the system.</br>\nSMB Share: Is a SMB share that is mounted to as a volume.\n",
"schema": {
"type": "string",
"required": true,
"default": "ix_volume",
"enum": [
{
"value": "host_path",
"description": "Host Path (Path that already exists on the system)"
},
{
"value": "ix_volume",
"description": "ixVolume (Dataset created automatically by the system)"
},
{
"value": "cifs",
"description": "SMB/CIFS Share (Mounts a volume to a SMB share)"
}
]
}
},
{
"variable": "read_only",
"label": "Read Only",
"description": "Mount the volume as read only.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "mount_path",
"label": "Mount Path",
"description": "The path inside the container to mount the storage.",
"schema": {
"type": "path",
"required": true
}
},
{
"variable": "host_path_config",
"label": "Host Path Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"host_path"
]
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "acl",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": [],
"$ref": [
"normalize/acl"
]
}
},
{
"variable": "path",
"label": "Host Path",
"description": "The host path to use for storage.",
"schema": {
"type": "hostpath",
"show_if": [
[
"acl_enable",
"=",
false
]
],
"required": true
}
}
]
}
},
{
"variable": "ix_volume_config",
"label": "ixVolume Configuration",
"description": "The configuration for the ixVolume dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"ix_volume"
]
],
"$ref": [
"normalize/ix_volume"
],
"attrs": [
{
"variable": "acl_enable",
"label": "Enable ACL",
"description": "Enable ACL for the storage.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "dataset_name",
"label": "Dataset Name",
"description": "The name of the dataset to use for storage.",
"schema": {
"type": "string",
"required": true,
"default": "storage_entry"
}
},
{
"variable": "acl_entries",
"label": "ACL Configuration",
"schema": {
"type": "dict",
"show_if": [
[
"acl_enable",
"=",
true
]
],
"attrs": []
}
}
]
}
},
{
"variable": "cifs_config",
"label": "SMB Configuration",
"description": "The configuration for the SMB dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"cifs"
]
],
"attrs": [
{
"variable": "server",
"label": "Server",
"description": "The server to mount the SMB share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "path",
"label": "Path",
"description": "The path to mount the SMB share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "username",
"label": "Username",
"description": "The username to use for the SMB share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "password",
"label": "Password",
"description": "The password to use for the SMB share.",
"schema": {
"type": "string",
"required": true,
"private": true
}
},
{
"variable": "domain",
"label": "Domain",
"description": "The domain to use for the SMB share.",
"schema": {
"type": "string"
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "labels",
"label": "",
"group": "Labels Configuration",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "label",
"label": "Label",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "key",
"label": "Key",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "value",
"label": "Value",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "containers",
"label": "Containers",
"description": "Containers where the label should be applied",
"schema": {
"type": "list",
"items": [
{
"variable": "container",
"label": "Container",
"schema": {
"type": "string",
"required": true,
"enum": [
{
"value": "minecraft-bedrock",
"description": "minecraft-bedrock"
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"variable": "resources",
"label": "",
"group": "Resources Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "limits",
"label": "Limits",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "cpus",
"label": "CPUs",
"description": "CPUs limit for Minecraft Bedrock.",
"schema": {
"type": "int",
"default": 2,
"required": true
}
},
{
"variable": "memory",
"label": "Memory (in MB)",
"description": "Memory limit for Minecraft Bedrock.",
"schema": {
"type": "int",
"default": 4096,
"required": true
}
}
]
}
}
]
}
}
]
},
"readme": "<h1>Minecraft Bedrock</h1> <p><a href=\"https://www.minecraft.net/en-us\">Minecraft Bedrock</a> Dedicated Server</p>",
"changelog": null,
"chart_metadata": {
"app_version": "2025.9.0",
"capabilities": [],
"categories": [
"games"
],
"changelog_url": "https://github.com/itzg/docker-minecraft-bedrock-server/releases",
"date_added": "2025-01-15",
"description": "Minecraft dedicated server for Bedrock platform hosts a world for multiplayer game.\nPlayers can join the server using the Bedrock client on Desktops, Mobiles, and consoles.\n",
"home": "https://www.minecraft.net/en-us",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/minecraft-bedrock/icons/icon.svg",
"keywords": [
"world",
"building"
],
"lib_version": "2.1.49",
"lib_version_hash": "e71e6b0122c9446fa5ea6fb07e7eb01b11fb42d549a19845426bbd7e21a42634",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "minecraft-bedrock",
"run_as_context": [
{
"description": "Minecraft runs as any non-root user.",
"gid": 568,
"group_name": "minecraft",
"uid": 568,
"user_name": "minecraft"
}
],
"screenshots": [],
"sources": [
"https://www.minecraft.net/en-us",
"https://github.com/itzg/docker-minecraft-bedrock-server"
],
"title": "Minecraft Server (Bedrock)",
"train": "community",
"version": "1.0.27"
}
}
}