Public | Automated Build

Last pushed: 8 months ago
Short Description
This repository contains an (hopefully) lightweight docker container for running Ubooquity.
Full Description


This is my take on an docker image for Ubooquity. @hurricanehrndz has made an image for us in his docker-containers repository*.
I felt that this wasn't entirely to my liking. Mostly because it's in an OS that I don't completely understand.

So I made this image based on Alpine Linux to keep it somewhat minimalistic, it's been running on my own server for a while now and I haven't run into any obvious problems.
It relies on you mounting directories for ubooquity data and for the comics (instructions below).

About Ubooquity

Home server for comics and ebooks

Ubooquity is a free, lightweight and easy-to-use home server for your comics and ebooks. Use it to access your files from anywhere, with a tablet, an e-reader, a phone or a computer.

Main features

  • Simple graphical interface to configure your server in a few minutes
  • Web administration page available if you prefer to do everything through your browser
  • User management with secured access, to decide who can see what
  • Online comic reader to read your comics without downloading huge files
  • Compatible with Calibre metadata, for better ebooks collection management
  • Can be installed on any OS supporting Java (Windows, Linux, Mac OS...) and on a wide range of hardware (desktop computer, server, NAS...)
  • Supports many types of files, with a preference for epub, cbz, cbr and PDF files

Copy-pasted from the Ubooquity homepage.

Getting started


Ensure that you have folders created for the ubooquity data on the host.
It's generally recommended to have some e-books or comics to mount in.

First run

Since the container doesn't come with any settings pre-done, we need to start it with the webadmin module enabled.
I would recommend to do this in an disposable container.

docker run --rm -ti -v /PATH/TO/UBOOQUITY/DATA:/opt/ubooquity-data -v /PATH/TO/COMICSANDBOOKS:/opt/data -p 2202:2202 cromigon/ubooquity:latest -webadmin

Now go into http://{YOUR_IP_ADDRESS}:2202/admin and do your configuration in accordance to the ubooquity documentation.

Exit the container when you are done, since we don't want to leave the webadmin running, if you need it again in the future, just stop the running container, run the above command again and log-in to the admin panel.

Second run

Now we've come to the part when we're going to run the long-running container. It's recommended (by me) to don't have it running with the webadmin part enabled. I also like to run my long-running containers have the restart=always flag enabled.

docker run --restart=always -d -v /PATH/TO/UBOOQUITY/DATA:/opt/ubooquity-data -v /PATH/TO/COMICSANDBOOKS:/opt/data -p 2202:2202 cromigon/ubooquity:latest

Now if you want to install themes or such, just put them in the themes folder in the ubooquity-data folder.


Code released under the MIT license.

Docker Pull Command
Source Repository