Homebox
Get Started with Apps!
Keywords: inventory, organization, management
Train: Community
Home Page: https://homebox.software
Added: 2025-04-23
Last Updated: 2025-05-02
Homebox is the inventory and organization system built for the Home User!
Run as Context- Homebox runs as any non-root user.
Group: 568 / homebox
User: 568 / homebox

App Metadata (Raw File)
{
"1.0.0": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/homebox/1.0.0",
"last_update": "2025-05-02 12:19:53",
"required_features": [],
"human_version": "0.18.0-rootless_1.0.0",
"version": "1.0.0",
"app_metadata": {
"app_version": "0.18.0-rootless",
"capabilities": [],
"categories": [
"management"
],
"date_added": "2025-04-23",
"description": "Homebox is the inventory and organization system built for the Home User!",
"home": "https://homebox.software",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/homebox/icons/icon.svg",
"keywords": [
"inventory",
"organization",
"management"
],
"lib_version": "2.1.18",
"lib_version_hash": "012ae94d28ee9d63c3c51a531bf5ac943e585015d5bcb1a6b20210b90d17dece",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "homebox",
"run_as_context": [
{
"description": "Homebox runs as any non-root user.",
"gid": 568,
"group_name": "homebox",
"uid": 568,
"user_name": "homebox"
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/homebox/screenshots/screenshot1.png"
],
"sources": [
"https://github.com/sysadminsmedia/homebox",
"https://homebox.software"
],
"title": "Homebox",
"train": "community",
"version": "1.0.0"
},
"schema": {
"groups": [
{
"name": "Homebox Configuration",
"description": "Configure Homebox"
},
{
"name": "User and Group Configuration",
"description": "Configure User and Group for Homebox"
},
{
"name": "Network Configuration",
"description": "Configure Network for Homebox"
},
{
"name": "Storage Configuration",
"description": "Configure Storage for Homebox"
},
{
"name": "Labels Configuration",
"description": "Configure Labels for Homebox"
},
{
"name": "Resources Configuration",
"description": "Configure Resources for Homebox"
}
],
"questions": [
{
"variable": "TZ",
"group": "Homebox Configuration",
"label": "Timezone",
"schema": {
"type": "string",
"default": "Etc/UTC",
"required": true,
"$ref": [
"definitions/timezone"
]
}
},
{
"variable": "homebox",
"label": "",
"group": "Homebox Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "additional_envs",
"label": "Additional Environment Variables",
"description": "Configure additional environment variables for Homebox.",
"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 Homebox Web files will be owned by.",
"schema": {
"type": "int",
"min": 568,
"default": 568,
"required": true
}
},
{
"variable": "group",
"label": "Group ID",
"description": "The group id that Homebox Web 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": "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": "web_port",
"label": "WebUI 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": 30149,
"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": "storage",
"label": "",
"group": "Storage Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "data",
"label": "Homebox Web Data Storage",
"description": "The path to store Homebox Web 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": "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": "homebox",
"description": "homebox"
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"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 Homebox Web.",
"schema": {
"type": "int",
"default": 2,
"required": true
}
},
{
"variable": "memory",
"label": "Memory (in MB)",
"description": "Memory limit for Homebox Web.",
"schema": {
"type": "int",
"default": 4096,
"required": true
}
}
]
}
}
]
}
}
]
},
"readme": "<h1>Homebox</h1> <p><a href=\"https://homebox.software/en/\">Homebox</a> is the inventory and organization system built for the Home User! With a focus on simplicity and ease of use, Homebox is the perfect solution for your home inventory, organization, and management needs.</p>",
"changelog": null,
"chart_metadata": {
"app_version": "0.18.0-rootless",
"capabilities": [],
"categories": [
"management"
],
"date_added": "2025-04-23",
"description": "Homebox is the inventory and organization system built for the Home User!",
"home": "https://homebox.software",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/homebox/icons/icon.svg",
"keywords": [
"inventory",
"organization",
"management"
],
"lib_version": "2.1.18",
"lib_version_hash": "012ae94d28ee9d63c3c51a531bf5ac943e585015d5bcb1a6b20210b90d17dece",
"maintainers": [
{
"email": "dev@ixsystems.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "homebox",
"run_as_context": [
{
"description": "Homebox runs as any non-root user.",
"gid": 568,
"group_name": "homebox",
"uid": 568,
"user_name": "homebox"
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/homebox/screenshots/screenshot1.png"
],
"sources": [
"https://github.com/sysadminsmedia/homebox",
"https://homebox.software"
],
"title": "Homebox",
"train": "community",
"version": "1.0.0"
}
}
}
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.