Bookshelf
Bookshelf
Get Started with Apps!
Get Started with Apps!
App Version:
hardcover-v0.4.20.119
Keywords: media, ebook, audiobook
Train: Community
Home Page: https://github.com/pennydreadful/bookshelf
Keywords: media, ebook, audiobook
Train: Community
Home Page: https://github.com/pennydreadful/bookshelf
Bookshelf Details
Added: 2026-01-09
Last Updated: 2026-01-29
Added: 2026-01-09
Last Updated: 2026-01-29
A place for your books. users.
Run as Context- Container [bookshelf] runs as root user and group.
Group: 0 / Host group is [root]
User: 0 / Host user is [root]
Screenshots
×
![Full Screenshot]()
Security Capabilities
- Bookshelf is able to change file ownership arbitrarily
- Bookshelf is able to bypass file permission checks
- Bookshelf is able to bypass permission checks for file operations
- Bookshelf is able to change group ID of processes
- Bookshelf is able to change user ID of processes
App Metadata (Raw File)
{
"1.0.7": {
"healthy": true,
"supported": true,
"healthy_error": null,
"location": "/__w/apps/apps/trains/community/bookshelf/1.0.7",
"last_update": "2026-01-29 09:47:00",
"required_features": [],
"human_version": "hardcover-v0.4.20.119_1.0.7",
"version": "1.0.7",
"app_metadata": {
"app_version": "hardcover-v0.4.20.119",
"capabilities": [
{
"description": "Bookshelf is able to change file ownership arbitrarily",
"name": "CHOWN"
},
{
"description": "Bookshelf is able to bypass file permission checks",
"name": "DAC_OVERRIDE"
},
{
"description": "Bookshelf is able to bypass permission checks for file operations",
"name": "FOWNER"
},
{
"description": "Bookshelf is able to change group ID of processes",
"name": "SETGID"
},
{
"description": "Bookshelf is able to change user ID of processes",
"name": "SETUID"
}
],
"categories": [
"media"
],
"changelog_url": "",
"date_added": "2026-01-09",
"description": "A place for your books. users.",
"home": "https://github.com/pennydreadful/bookshelf",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/bookshelf/icons/icon.png",
"keywords": [
"media",
"ebook",
"audiobook"
],
"lib_version": "2.1.77",
"lib_version_hash": "1837f8e69ae1adc313330c3b1c2615e9b4d03c5459d657a5898bae78090f8195",
"maintainers": [
{
"email": "dev@truenas.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "bookshelf",
"run_as_context": [
{
"description": "Container [bookshelf] runs as root user and group.",
"gid": 0,
"group_name": "Host group is [root]",
"uid": 0,
"user_name": "Host user is [root]"
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/bookshelf/screenshots/screenshot1.png",
"https://media.sys.truenas.net/apps/bookshelf/screenshots/screenshot2.png",
"https://media.sys.truenas.net/apps/bookshelf/screenshots/screenshot3.png"
],
"sources": [
"https://github.com/pennydreadful/bookshelf"
],
"title": "Bookshelf",
"train": "community",
"version": "1.0.7"
},
"schema": {
"groups": [
{
"name": "Bookshelf Configuration",
"description": "Configure Bookshelf"
},
{
"name": "User and Group Configuration",
"description": "Configure User and Group for Bookshelf"
},
{
"name": "Network Configuration",
"description": "Configure Network for Bookshelf"
},
{
"name": "Storage Configuration",
"description": "Configure Storage for Bookshelf"
},
{
"name": "Labels Configuration",
"description": "Configure Labels for Bookshelf"
},
{
"name": "Resources Configuration",
"description": "Configure Resources for Bookshelf"
}
],
"questions": [
{
"variable": "bookshelf",
"label": "",
"group": "Bookshelf Configuration",
"schema": {
"type": "dict",
"attrs": [
{
"variable": "instance_name",
"label": "Instance Name",
"description": "The name of the Bookshelf instance.",
"schema": {
"type": "string",
"default": "Bookshelf",
"required": true
}
},
{
"variable": "image_selector",
"label": "Image Type",
"description": "The type of image to use as a metadata provider.\n\nThe hardcover tags use Hardcover as a metadata provider. <br/>\nThis metadata is higher quality but isn't backward-compatible; </br></br>\n\nThe softcover tags use Goodreads as the metadata provider. <br/>\nThe quality of this metadata is generally poor and contains a lot of slop. </br>\nHowever, it is backward-compatible with existing Bookshelf databases and\nfunctionality like Goodreads list imports should continue to work normally.</br></br>\n\nChanging between these two options requires redeploying Bookshelf from scratch.\n",
"schema": {
"type": "string",
"default": "image",
"required": true,
"immutable": true,
"enum": [
{
"value": "image",
"description": "Hardcover Metadata Provider"
},
{
"value": "softcover",
"description": "Goodreads Metadata Provider"
}
]
}
},
{
"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 Bookshelf files will be owned by.",
"schema": {
"type": "int",
"min": 568,
"default": 568,
"required": true
}
},
{
"variable": "group",
"label": "Group ID",
"description": "The group id that Bookshelf 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": "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": 30378,
"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": "config",
"label": "Config Storage",
"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": "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": "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.</br>\nNFS Share: Is a NFS 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)"
},
{
"value": "nfs",
"description": "NFS Share (Mounts a volume to a NFS 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": "nfs_config",
"label": "NFS Configuration",
"description": "The configuration for the NFS dataset.",
"schema": {
"type": "dict",
"show_if": [
[
"type",
"=",
"nfs"
]
],
"attrs": [
{
"variable": "server",
"label": "Server",
"description": "The server to mount the NFS share.",
"schema": {
"type": "string",
"required": true
}
},
{
"variable": "path",
"label": "Path",
"description": "The path to mount the NFS share.",
"schema": {
"type": "string",
"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": "bookshelf",
"description": "bookshelf"
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"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 Bookshelf.",
"schema": {
"type": "int",
"default": 2,
"required": true
}
},
{
"variable": "memory",
"label": "Memory (in MB)",
"description": "Memory limit for Bookshelf.",
"schema": {
"type": "int",
"default": 4096,
"required": true
}
}
]
}
}
]
}
}
]
},
"readme": "<h1>Bookshelf</h1> <p><a href=\"https://github.com/pennydreadful/bookshelf\">Bookshelf</a> is an ebook and audiobook collection manager for Usenet and BitTorrent users.</p>",
"changelog": null,
"chart_metadata": {
"app_version": "hardcover-v0.4.20.119",
"capabilities": [
{
"description": "Bookshelf is able to change file ownership arbitrarily",
"name": "CHOWN"
},
{
"description": "Bookshelf is able to bypass file permission checks",
"name": "DAC_OVERRIDE"
},
{
"description": "Bookshelf is able to bypass permission checks for file operations",
"name": "FOWNER"
},
{
"description": "Bookshelf is able to change group ID of processes",
"name": "SETGID"
},
{
"description": "Bookshelf is able to change user ID of processes",
"name": "SETUID"
}
],
"categories": [
"media"
],
"changelog_url": "",
"date_added": "2026-01-09",
"description": "A place for your books. users.",
"home": "https://github.com/pennydreadful/bookshelf",
"host_mounts": [],
"icon": "https://media.sys.truenas.net/apps/bookshelf/icons/icon.png",
"keywords": [
"media",
"ebook",
"audiobook"
],
"lib_version": "2.1.77",
"lib_version_hash": "1837f8e69ae1adc313330c3b1c2615e9b4d03c5459d657a5898bae78090f8195",
"maintainers": [
{
"email": "dev@truenas.com",
"name": "truenas",
"url": "https://www.truenas.com/"
}
],
"name": "bookshelf",
"run_as_context": [
{
"description": "Container [bookshelf] runs as root user and group.",
"gid": 0,
"group_name": "Host group is [root]",
"uid": 0,
"user_name": "Host user is [root]"
}
],
"screenshots": [
"https://media.sys.truenas.net/apps/bookshelf/screenshots/screenshot1.png",
"https://media.sys.truenas.net/apps/bookshelf/screenshots/screenshot2.png",
"https://media.sys.truenas.net/apps/bookshelf/screenshots/screenshot3.png"
],
"sources": [
"https://github.com/pennydreadful/bookshelf"
],
"title": "Bookshelf",
"train": "community",
"version": "1.0.7"
}
}
}Support, maintenance, and documentation for applications within the Community catalog is handled by the TrueNAS community. The TrueNAS Applications Market 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 add resources here or discuss this application in the TrueNAS Community forum.