⚠ Open Issue : 🐛 [Calibre] Waiting for stream... / WebSocket disconnected. Attempting to reconnect... / Connection established. Waiting for server mode... (opened 2025-09-25) by @codyc1515

Home assistant add-on: calibre

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

Calibre is a powerful and easy to use e-book manager. Users say it’s outstanding and a must-have. It’ll allow you to do nearly everything and it takes things a step beyond normal e-book software. It’s also completely free and open source and great for both casual users and computer experts.

This addon is based on the docker image https://github.com/linuxserver/docker-calibre

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other add-on.

Add my add-ons repository to your home assistant instance (in supervisor addons store at top right, or click button below if you have configured my HA)
Install this add-on.
Click the Save button to store your configuration.
Set the add-on options to your preferences
Start the add-on.
Check the logs of the add-on to see if everything went well.
Open the webUI and adapt the software options

Configuration

Webui can be found at http://homeassistant:PORT or through the sidebar using Ingress. Please read the upstream container documentation for further info: https://github.com/linuxserver/docker-calibre#application-setup

Note: The webserver and wireless connection need to be manually enabled from the desktop app, using ports 8081 and 9090 respectively.

Options

Option	Type	Default	Description
`PGID`	int	`0`	Group ID for file permissions
`PUID`	int	`0`	User ID for file permissions
`TZ`	str		Timezone (e.g., `Europe/London`)
`PASSWORD`	str		Optional password for GUI access
`CLI_ARGS`	str		Optional CLI start arguments for Calibre
`localdisks`	str		Local drives to mount (e.g., `sda1,sdb1,MYNAS`)
`networkdisks`	str		SMB shares to mount (e.g., `//SERVER/SHARE`)
`cifsusername`	str		SMB username for network shares
`cifspassword`	str		SMB password for network shares
`cifsdomain`	str		SMB domain for network shares

Example Configuration

PGID: 0
PUID: 0
TZ: "Europe/London"
PASSWORD: "secure-password"
CLI_ARGS: "--with-library=/books"
localdisks: "sda1,sdb1"
networkdisks: "//192.168.1.100/books"
cifsusername: "bookuser"
cifspassword: "password123"
cifsdomain: "workgroup"

Mounting Drives

This addon supports mounting both local drives and remote SMB shares:

Local drives: See Mounting Local Drives in Addons
Remote shares: See Mounting Remote Shares in Addons

Custom Scripts and Environment Variables

This addon supports custom scripts and environment variables through the addon_config mapping:

Custom scripts: See Running Custom Scripts in Addons
env_vars option: Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Support

Create an issue on github

6.1 KiB Raw Blame History Unescape Escape