1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-12 19:22:24 +00:00
iiab/roles/calibre-web
2018-08-15 20:35:45 +07:00
..
defaults Updated Systemd unit, use metadata.db as default 2018-08-15 20:35:45 +07:00
files Adding a pre-provisioned metadata.db file 2018-08-15 20:35:45 +07:00
tasks Adding cps.conf to encapsulate the variables in systemd unit 2018-08-15 20:35:45 +07:00
templates Adding cps.conf to encapsulate the variables in systemd unit 2018-08-15 20:35:45 +07:00
README.rst [Untested] Automatic provisioning with 'app.db' 2018-08-15 20:35:45 +07:00

====================
Calibre-web README
====================

This Ansible role installs Calibre Web within Internet-in-a-Box. Calibre Web is
a web app providing a clean interface for browsing, reading and downloading eBooks
using an existing Calibre database.

Access
------

If enabled and with the default settings Calibre-web should be accessible at http://box/calibre-web.
This is front-end application running under Apache2 httpd.

To login to Calibre-web enter

  Username: admin

  Password: changme

Backend
--------
You can manage the backend Calibre-web server manually with the following commands:

  systemctl enable calibre-web

  systemctl start calibre-web

  systemctl status calibre-web

  systemctl stop calibre-web

Configuration
-------------
You can login using the default administration account. Then select "Configuration"
under admin panel.

Upgrading
---------
Reinstalling Calibre-web automatically upgrades to the latest version. Please backup your configuration
before reinstalling. To retain your configuration set calibreweb_provision variable to False.

You can manually upgrade while following commands:

$ cd /opt/calibre-web

$ sudo git pull

Backup Content
--------------
Calibre-web stores its configuration into SQLite database file /library/calibre-web/app.db.
The content is stored in various folders under /library/calibre-web. Please backup the files before
upgrading. Also set calibreweb_provision variable to False before upgrading.

Known Issues
------------
Current implementation of the calibre-web in Internet in a box doesn't include https/SSL configuration.
Some of the administration login urls might not work.