Home assistant addon : Ubooquity

Tags: #<Tag:0x00007f32552b56b8> #<Tag:0x00007f32552b5550>

Supports aarch64 Architecture Supports amd64 Architecture Supports armhf Architecture Supports armv7 Architecture

Hi, I’ve create an addon for my use and wanted to share it if it can be useful to other people :wink:


Ubooquity by vaemendis is a free, lightweight and easy-to-use home server for your comics and ebooks developed . This addon is based on the docker image from linuxserver.io.

Ubooquity supports many types of files, with a preference for ePUB, CBZ, CBR and PDF files. Metadata from library management software Calibre and ComicRack are also supported. Ubooquity lets you create user accounts and set access rights for each shared folder.

This addons has several configurable options :

  • allowing to mount local external drive, or smb share from the addon (decreases performance)
  • VERY IMPORTANT, CAN CRASH SYSTEM : Setting of the maximum RAM usage for java. The quantity of memory allocated to Ubooquity depends on the hardware your are running it on. If this quantity is too small, you might sometime saturate it with when performing memory intensive operations and you’ll get “java.lang.OutOfMemoryError: Java heap space errors”. If the quantity allocated is too high for your system, it will crash home assistant and you’ll need to manually reboot. Value is a number of megabytes ( put just a number, without MB).

It is recommended to enable OPDS server from option, then you can connect to your comics/eBook server from a mobile app (I use Chunky on iOS (paid), Kuboo on android (free))


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

  1. Add my Hass.io add-ons repository to your home assistant instance.
  2. Install this add-on.
  3. Click the Save button to store your configuration.
  4. Set the add-on options to your preferences
  5. Start the add-on.
  6. Check the logs of the add-on to see if everything went well.
  7. Open the webUI, set an admin password and adapt the administration options


Admin webui can be found at http://your-ip:2203.
Library webui can be found at http://your-ip:2202. You can also access it by clicking on the ubooquity logo at top left of the admin page, or use a mobile app (preferred option, see above for instructions)
The default username/password : described in the startup log.
Configurations can be done through the app webUI, except for the following options

Network disk is mounted to /mnt/share name

GUID: user
GPID: user
maxmem: 200 # IMPORTANT read above. 200 is default for rpi3b+ ; 512 recommended if more 2gb RAM. 
networkdisks: "<//SERVER/SHARE>" # list of smbv2/3 servers to mount (optional)
cifsusername: "username" # smb username (optional)
cifspassword: "password" # smb password (optional)
smbv1: false # Should smbv1 be used instead of 2.1+?