# 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;`