Calibre v9 broke my calibre-web server 

Tags :

I use calibre to manage my e-books, and I’ve setup a docker container on my Synology to serve them to my friends and family via calibre-web. Everything has been running smoothly for the last year or so.

Calibre got updated to version 9 today, and it turned out I had a few books to add to my library. I updated without a second thought, as all previous updates didn’t cause a hitch. What could possibly go wrong…?

I use an rsync script to update the database on my Synology, and today my calibre-web server broke. No books were displayed anymore, and all sidebar sorting links (categories, series, authors, etc.), generated an internal 500 error on the server:

sqlite3.OperationalError: no such column: books.isbn

It looked like a database schema mismatch.

I diffed my metadata.db with the sample file provided by calibre-web, and sure enough, 2 columns were missing (isbn and lccn) in the metadata.db file I had just tranferred.

This is how I checked if the column was missing:

docker exec -it calibre-web sh -lc 'sqlite3 /books/metadata.db ".schema books" | head -n 50'

Needless to say, I thought I was responsible for breaking something along the way, so I reinstalled a fresh container (v0.6.25) multiple times to no avail.

I ended up by posting a comment in an open issue on GitHub “Server error after updating calibre desktop version to 9.0. (Mac OS)”.

A temporary fix was suggested by uriel1998 that I applied to my container with the following docker command:

docker run --rm -it -v "/volume1/web/books:/books" nouchka/sqlite3 /books/metadata.db "ALTER TABLE books ADD COLUMN isbn INTEGER; ALTER TABLE books ADD COLUMN flags ANY;"

As long as I don’t run my rsync script, this will do the trick waiting for a fix.

Warning: don’t do this on your main metadata.db file, only on a copy.

21:50 Update

dinosmm confirms:

the database schema changed slightly with Calibre v9, some columns, which were previously unused anyway, got removed, and this is what broke calibre-web.

Kovid Goyal explains it here: https://www.mobileread.com/forums/showpost.php?p=4563776&postcount=2

Recent Logs — or the next 10 entries

Well, they might not be all that recent. You'll find the older entries in the archives.

  • Streets of Minneapolis

    → It’s dedicated to the people of Minneapolis, our innocent immigrant neighbors and in memory of Alex Pretti and Renee Good.

  • (Sigh)

    If you put the Apple icons in reverse it looks like the portfolio of someone getting really really good at icon design.

  • CSS anchor positioning

    CSS Anchor positioning allows placing elements anywhere on the page relative to an “anchor element”, without regard to the layout of other elements besides their containing block. Click on the video below to have Jake present it much better than I ever can.

  • Looking in the same direction

    29 years and going strong

  • Unimaginable

    Lets insist that such a failure of safety and care is never repeated.

  • Wrapped in numbers

    I don’t know about you, but this year I’ve received “Year in review / Wrapped / Recap / Replay 2025” from an increasing number of services. This led me to start digging into the numbers of the various services I use.

  • Slow down

    As this solar revolution gently comes to a close, it’s time to take a breath and reflect on what it was made of for me.

  • YouTube error 153

    I recently encountered a YouTube embed error for the first time: Error 153 - Video player configuration error.

  • Wish You Were Here

    My favourite Pink Floyd album has just turned 50.

  • Peak Design Roller Pro vs Rimowa Hybrid Cabin

    My Peak Design Roller Pro Kickstarter carry-on landed in my office this week, and although I haven’t had the opportunity to to travel with it, I wanted to compare it to my current carry-on, the Rimowa Hybrid Cabin.

More entries »

Paros — Unplugged in my favourite place / 2025

Pictures of food and cats from your break in Paros

Paros remains one of my favourite spots to let go, unplug and relax with friends, good food and fabulous weather.