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-04-23
Minecraft dedicated server for Bedrock platform.
Run as Context- Minecraft runs as any non-root user.
Group: 568 / minecraft
User: 568 / minecraft
App Metadata (Raw File)
{
"1.0.16": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/minecraft-bedrock/1.0.16",
"last_update": "2025-04-23 17:43:28",
"required_features": [],
"human_version": "2025.4.0_1.0.16",
"version": "1.0.16",
"app_metadata": {
"app_version": "2025.4.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.",
"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.16",
"lib_version_hash": "dac15686f882b9ce65b8549a3d5c0ed7bafe2df7a9028880d1a99b0ff4af1eff",
"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.16"
},
"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",
"description": "Configure additional environment variables for Minecraft Bedrock.",
"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",
"required": true
}
}
]
}
}
]
}
}
]
}
},
{
"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,
"required": true,
"$ref": [
"definitions/port"
]
}
},
{
"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,
"immutable": 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,
"immutable": 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",
"description": "Additional storage for Minecraft Bedrock.",
"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",
"immutable": true,
"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,
"immutable": 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.4.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.",
"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.16",
"lib_version_hash": "dac15686f882b9ce65b8549a3d5c0ed7bafe2df7a9028880d1a99b0ff4af1eff",
"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.16"
}
}
}
Support, maintenance, and documentation for applications within the Community catalog is handled by the TrueNAS community. The TrueNAS Applications Portal hosts but does not validate or maintain any linked resources associated with this app.
There currently aren’t any resources available for this application!
Please help the TrueNAS community create content or discuss this application in the TrueNAS Community forum.