small_server_thingies/calibre-web/readme.md
2022-12-29 22:25:12 +01:00

15 lines
No EOL
1.3 KiB
Markdown

# Calibre-web
- You can install with the attached docker-compose. You will only need to add a `.env` file to inform of the
`ROOT_PATH` where the volumes should be mounted in the host.
- Calibre-web is initially suposed to be a layer on top of an existing calibre installation. Because of that, the
container does not initialize a books library on its own. This prevents the service from working properly (you will
get stuck in the first screen, being asked for a config and getting an error message constantly). To overcome this,
you simply need to drop an empty calibre database in the `/books` path in the container. A file you can use goes
along with this readme file.
- By default, you can't upload books through the web UI. You need to go to
`Admin > Edit Basic Configuration > Feature Configuration > Enable Uploads`. After that, permission needs to be given
to every user who should be allowed to upload books.
- The app allows OPDS connections from ebooks. To set it up, pass to the ebook the web URL with `/opds` at the end.
- Books can easily exceed the default max upload size allowed by nginx. To increase it, you simply need to put the
following directive under nginx's reverse proxy section for calibre: `client_max_body_size <your megabytes choice>M;`