Setting up Calibre Server on Digital Ocean

Rae Knowler
17 Mar 2019, 1:47 p.m.

I read a lot, both on paper and on an e-reader, and recently I've been using Calibre to organise and tag my ebooks. Calibre is free and open-source software and I love it! What would be even cooler, though, is having access to my meticulously organised collection on the go, so I could look up novels whose titles are on the tip of my tongue, easily download something new to read on my phone, or send books to friends who would appreciate them when I think of it, instead of waiting till later and probably forgetting. (Where legally appropriate, of course.) That's where the Calibre Content Server comes in.

I'm thinking of switching to Digital Ocean for my hosting, so this seemed like a good first project to try there. My plan was to set up a Calibre server on a droplet and use rsync to keep the library there up-to-date with the one on my laptop. That way, I can add more books and metadata in one place and access them everywhere.

There's already a tutorial for this on the Digital Ocean site, but it uses Ubuntu 14.04. The default Ubuntu version on DO now is 18.04 and a few things have changed. Here's how I got things running.

Droplet setup

I created my DO account and added a new droplet, the smallest size, with 1GB memory and 25GB disk space. Then I followed their tutorial for initial server setup on Ubuntu 18.04. Note that the tutorial includes setting up a firewall (UFW) to deny all connections except SSH. The Calibre server listens for HTTP traffic on port 8080, so you'll have to allow that:

sudo ufw allow 8080

My sudo user is called rae. If you see that name in commands on this page, you should replace it with your own user.

Installing and running Calibre

The Digital Ocean tutorial mentions that you should check the official Calibre page to see if the installation command has changed. It has, and currently it's:

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

I found that I had to install one more dependency than mentioned in the tutorial to get Calibre working. (Thanks, snesbitt!)

sudo apt-get install libfontconfig

When I got to running the server, I also saw this error:

No write acces to /home/rae/.config/calibre using a temporary dir instead

This was solved by changing the /home/rae/.config directory to be owned by my user instead of root.

sudo chown rae:rae ~/.config

Uploading my library

The tutorial tells you to upload your library without explaining how. I used scp, in a terminal on my laptop:

scp -r ~/Calibre\ Library/ rae@xxx.xxx.xxx.xxx:calibre_library

Here, ~/Calibre\ Library/ is my local library folder. Replace my username, rae, with yours and xxx.xxx.xxx.xxx with the IP address of your droplet. calibre_library is the name I picked for the new library folder on the droplet.

I could now run Calibre from the droplet using the following command, and access it by going to xxx.xxx.xxx.xxx:8080 in the browser. Hooray!

calibre-server ./calibre_library

Adding a server user

The information in the tutorial on running Calibre in the background, including adding password security, is all outdated. Luckily, the official Calibre docs are up-to-date. The currently recommended way to manage users is to create a database, which also allows you to have multiple different users.

I followed the instructions in the Calibre docs, using the following command to create a Sqlite user database and add a user for myself:

calibre-server --userdb /srv/calibre/users.sqlite --manage-users

Then I ran Calibre again, with authentication enabled:

calibre-server --userdb /srv/calibre/users.sqlite --enable-auth

Now, when you visit your server in the browser, you will be prompted to login.

Running Calibre in the background

Again, the Calibre docs are the way to go here. They use systemd, instead of the outdated Upstart service described in the Digital Ocean docs.

To keep using the auth you just set up when running the Calibre server automatically, make sure to change the ExecStart line of the service config in the docs. It should look like this:

ExecStart=/opt/calibre/calibre-server "/home/rae/calibre_library" --userdb "/srv/calibre/users.sqlite" --enable-auth

At this point, I noticed an error saying that Calibre was trying to write to a non-writeable database. The user that systemd was running the command with did not have write access to the user database. To allow this, I ran this command, which gives write access to my user plus all users in my group:

chmod +w /srv/calibre/users.sqlite

Updating the Calibre library automatically

The Digital Ocean tutorial suggests a way to update the server's library by adding books to a folder on the droplet. This wasn't what I wanted: I want to be able to mess with my library locally and see the changes reflected on the server. I decided to use rsync to update the server library.

I ran this command to add a new cron on my laptop:

crontab -e

This is what I added:

*/10 * * * * rsync -r ~/Calibre\ Library/ rae@xxx.xxx.xxx.xxx:calibre_library

Every ten minutes, this will run rsync between my local Calibre library and the one on the server. (Remember to use your own username and droplet IP address.) This will only upload the necessary data when something has actually changed, instead of copying everything over like scp did.

I then added a cron on my droplet to restart the Calibre server every hour. This is necessary so that Calibre recognises the newly added books.

0 * * * * sudo systemctl restart calibre-server

Conclusion

The endnotes of the Digital Ocean tutorial, regarding copyrights, updates and security, are worth reading.

In Switzerland, where I live, filesharing is legal so long as you're only downloading the files. Uploading copyrighted files for sharing is illegal. That's why it was important to me to password-protect my server, as it contains copyrighted books I've bought new, out-of-copyright books from Project Gutenberg and similar sources, and all manner of other junk. Incidentally, although I disapprove of pirating books, I also prefer to strip DRM from files I've legally bought. Apprentice Alf's DeDRM plugin for Calibre is a wonderful tool for this and I recommend it.

I hope you get your own Calibre servers up and running easily. Enjoy reading your ebooks from anywhere you have a browser!