Terraria
Terraria
Get Started with Apps!
Get Started with Apps!
App Version: tshock-1.4.4.9-5.2.2
(Changelog)
Keywords: adventure, building, game, terraria, world
Train: Community
Home Page: https://terraria.org/
Keywords: adventure, building, game, terraria, world
Train: Community
Home Page: https://terraria.org/
Terraria Details
Added: 2024-09-17
Last Updated: 2025-04-23
Added: 2024-09-17
Last Updated: 2025-04-23
Terraria is a land of adventure! A land of mystery! A land that's yours to shape, defend, and enjoy.
Run as Context- Terraria runs as root user.
Group: 0 / root
User: 0 / root
×
![Full Screenshot]()
App Metadata (Raw File)
{
"1.1.17": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/terraria/1.1.17",
"last_update": "2025-04-23 17:43:28",
"required_features": [],
"human_version": "tshock-1.4.4.9-5.2.2_1.1.17",
"version": "1.1.17",
"app_metadata": {
"app_version": "tshock-1.4.4.9-5.2.2",
"capabilities": [],
"categories": [
"games"
],
"changelog_url": "https://github.com/ryansheehan/terraria/releases",
"date_added": "2024-09-17",
"description": "Terraria is a land of adventure! A land of mystery! A land that's yours to shape, defend, and enjoy.",
"home": "https://terraria.org/",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/terraria/icons/icon.png",
"keywords": [
"adventure",
"building",
"game",
"terraria",
"world"
],
"lib_version": "2.1.16",
"lib_version_hash": "dac15686f882b9ce65b8549a3d5c0ed7bafe2df7a9028880d1a99b0ff4af1eff",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "terraria",
"run_as_context": [
{
"description": "Terraria runs as root user.",
"gid": 0,
"group_name": "root",
"uid": 0,
"user_name": "root"
}
],
"screenshots": [],
"sources": [
"https://terraria.org/",
"https://github.com/ryansheehan/terraria"
],
"title": "Terraria",
"train": "community",
"version": "1.1.17"
},
"schema": {
"groups": [
{
"name": "Terraria Configuration",
"description": "Configure Terraria"
},
{
"name": "Network Configuration",
"description": "Configure Network for Terraria"
},
{
"name": "Storage Configuration",
"description": "Configure Storage for Terraria"
},
{
"name": "Labels Configuration",
"description": "Configure Labels for Terraria"
},
{
"name": "Resources Configuration",
"description": "Configure Resources for Terraria"
}
],
"questions": [
{
"variable": "terraria",
"label": "",
"group": "Terraria Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "image_selector",
"label": "Image",
"description": "Selects the image to use for the Terraria server.</br>\nTShock is a fork of the Terraria server that adds a number of features.</br>\nVanilla is the original Terraria server. </br>\nOnly applies to newly generated worlds.\n",
"schema": {
"type": "string",
"default": "image",
"immutable": true,
"required": true,
"enum": [
{
"value": "image",
"description": "TShock Image"
},
{
"value": "vanilla_image",
"description": "Vanilla Image"
}
]
}
},
{
"variable": "world_name",
"label": "World Name",
"description": "Sets the world's name.</br>\nOnly applies to newly generated worlds.\n",
"schema": {
"type": "string",
"default": "world",
"valid_chars": "^[a-zA-Z0-9-]+$",
"valid_chars_error": "World name must be [numbers, letters, and hyphens only]",
"required": true,
"immutable": true
}
},
{
"variable": "world_seed",
"label": "World Seed",
"description": "Sets the world's seed.</br>\nOnly applies to newly generated worlds.\n",
"schema": {
"type": "string",
"default": "",
"immutable": true
}
},
{
"variable": "world_evil",
"label": "World Evil",
"description": "Sets the world's evil state.</br>\nOnly applies to newly generated worlds.\n",
"schema": {
"type": "string",
"default": "random",
"required": true,
"immutable": true,
"enum": [
{
"value": "random",
"description": "Random"
},
{
"value": "corrupt",
"description": "Corrupt"
},
{
"value": "crimson",
"description": "Crimson"
}
]
}
},
{
"variable": "world_size",
"label": "World Size",
"description": "Sets the world's size.</br>\nOnly applies to newly generated worlds.\n",
"schema": {
"type": "string",
"default": "small",
"required": true,
"immutable": true,
"enum": [
{
"value": "small",
"description": "Small (1)"
},
{
"value": "medium",
"description": "Medium (2)"
},
{
"value": "large",
"description": "Large (3)"
}
]
}
},
{
"variable": "world_difficulty",
"label": "World Difficulty",
"description": "Sets the world's difficulty.</br>\nOnly applies to newly generated worlds.\n",
"schema": {
"type": "string",
"default": "normal",
"required": true,
"immutable": true,
"enum": [
{
"value": "normal",
"description": "Normal (0)"
},
{
"value": "expert",
"description": "Expert (1)"
},
{
"value": "master",
"description": "Master (2)"
},
{
"value": "journey",
"description": "Journey (3)"
}
]
}
},
{
"variable": "max_players",
"label": "Maximum Players",
"description": "Starts the server with the given player count as the maximum.",
"schema": {
"type": "int",
"default": 8,
"min": 1,
"max": 255,
"required": true
}
},
{
"variable": "password",
"label": "Server Password",
"description": "Sets the server password.",
"schema": {
"type": "string",
"private": true,
"default": ""
}
},
{
"variable": "secure",
"label": "Secure Server",
"description": "Turns on the base game's \"anti-spam\" feature.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "force_update",
"label": "Force Update",
"description": "Forces the server to continue running, and not hibernating when no players are on. </br>\nThis results in time passing, grass growing, and cpu running.\n",
"schema": {
"type": "boolean",
"default": false
}
},
{
"variable": "additional_args",
"label": "Additional Arguments",
"description": "Configure additional arguments for Terraria. </br>\nValue is optional for flags like -heaptile </br>\nFor example: </br>\nKey: -lang </br>\nValue: en-US\n",
"schema": {
"type": "list",
"default": [],
"items": [
{
"variable": "arg",
"label": "Argument",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "key",
"label": "Key",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "value",
"label": "Value",
"schema": {
"type": "string"
}
}
]
}
}
]
}
},
{
"variable": "additional_envs",
"label": "Additional Environment Variables",
"description": "Configure additional environment variables for Terraria.",
"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": "network",
"label": "",
"group": "Network Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "server_port",
"label": "Server Port",
"description": "The port for Terraria Server",
"schema": {
"type": "int",
"default": 30030,
"required": true,
"$ref": [
"definitions/port"
]
}
},
{
"variable": "tshock_api_port",
"label": "TShock API 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": "",
"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": 31103,
"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": "config",
"label": "Terraria Config Storage",
"description": "The path to store Terraria Config.",
"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,
"immutable": true,
"hidden": true,
"default": "config"
}
},
{
"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": "world",
"label": "Terraria World Storage",
"description": "The path to store Terraria World.",
"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": "world"
}
},
{
"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": "plugins",
"label": "Terraria Plugins Storage",
"description": "The path to store Terraria Plugins.",
"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": "plugins"
}
},
{
"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 Terraria.",
"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": [],
"$ref": [
"normalize/acl"
]
}
}
]
}
},
{
"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": "terraria",
"description": "terraria"
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"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 Terraria.",
"schema": {
"type": "int",
"default": 2,
"required": true
}
},
{
"variable": "memory",
"label": "Memory (in MB)",
"description": "Memory limit for Terraria.",
"schema": {
"type": "int",
"default": 4096,
"required": true
}
}
]
}
}
]
}
}
]
},
"readme": "<h1>Terraria</h1> <p><a href=\"https://terraria.org/\">Terraria</a> is a land of adventure! A land of mystery! A land that's yours to shape, defend, and enjoy.</p> <p><strong>NOTE:</strong> The following applies only for the <code>TShock</code> image. On the first run, you have to check the logs to get the server token. You will find something like this:</p> <p><code>text Login before join enabled. Users may be prompted for an account specific password instead of a server password on connect. Login using UUID enabled. Users automatically login via UUID. A malicious server can easily steal a user's UUID. You may consider turning this option off if you run a public server. TShock Notice: setup-code.txt is still present, and the code located in that file will be used. To setup the server, join the game and type /setup 424041 This token will display until disabled by verification. (/setup)</code></p> <p>Join the server and run <code>/setup <token></code></p>",
"changelog": null,
"chart_metadata": {
"app_version": "tshock-1.4.4.9-5.2.2",
"capabilities": [],
"categories": [
"games"
],
"changelog_url": "https://github.com/ryansheehan/terraria/releases",
"date_added": "2024-09-17",
"description": "Terraria is a land of adventure! A land of mystery! A land that's yours to shape, defend, and enjoy.",
"home": "https://terraria.org/",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/terraria/icons/icon.png",
"keywords": [
"adventure",
"building",
"game",
"terraria",
"world"
],
"lib_version": "2.1.16",
"lib_version_hash": "dac15686f882b9ce65b8549a3d5c0ed7bafe2df7a9028880d1a99b0ff4af1eff",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "terraria",
"run_as_context": [
{
"description": "Terraria runs as root user.",
"gid": 0,
"group_name": "root",
"uid": 0,
"user_name": "root"
}
],
"screenshots": [],
"sources": [
"https://terraria.org/",
"https://github.com/ryansheehan/terraria"
],
"title": "Terraria",
"train": "community",
"version": "1.1.17"
}
}
}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.