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))
Installation
The installation of this add-on is pretty straightforward and not different in comparison to installing any other 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, set an admin password and adapt the administration options
Configuration
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+?
Great addon. I was looking into installing something for my ebooks and then I stumbled over this.
Sadly it wont work over ssl without keystore and I have yet to find a good way of importing my lets encrypt certificate. Until I figure that out the addon will lie dormant because I really cant integrate it anywhere (not even into a custom panel).
Anyone got a solution for the ssl probem?
Also I couldn’t really find what the GUID and GPID are for
Thanks! Well then I could implement a nginx server to serve https, I’ll look at that!
GUID means group id and PUID is the user id, it is used to run the container into something else than root. I don’t personaly use it, but here is more documentation : Understanding PUID and PGID - LinuxServer.io
Hello, ssl is enable for ubooquity in the latest update. It is possible to access the UI through http(or https)://YOURIP:2202/ubooquity ; and the admin interface through http(or https)://YOURIP:2203/ubooquity/admin
Thanks so much for this add on. I’m really looking forward to using it! I seem to be running into issues with the nginx server, unfortunately. I currently have the nginx ssl proxy configured for enabling local http and external https. When starting this add on, I am getting this message:
[22:24:09] INFO: Starting NGinx...
nginx: [emerg] invalid port in "172.30.33.12:" of the "listen" directive in /etc/nginx/servers/ingress.conf:2
20211129 22:24:09 [Thread-2] INFO com.ubooquity.b - Stopping internal server...
20211129 22:24:09 [Thread-2] INFO com.ubooquity.data.feeder.a - Aborting content scan...
Any suggestions or ideas would be greatly appreciated!
Oh I see the issue. I started enabling ingress, but to enable it there would have been a breaking change so I stopped and some files remained. I’ll push a new version now
only with ssl enabled. I get the error 400 Bad Request The plain HTTP request was sent to HTTPS port. Alle the other dashboard links (comics, latest comics, latest books) work on ssl
It just means that there is no hdd connected available with the name sda… Not sure what you could try. With which url are you accessing the main dashboard? YOURIP:YOURPORT/ubooquity/?
