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-26 14:37:17 +07:00
..
defaults Refactor: Provision calibre-web settings 2018-08-26 14:30:38 +07:00
files Adding 'app.db' settings with IIAB provisioning settings 2018-08-26 13:59:17 +07:00
tasks Refactor: Use pip extra_args to handle 'pip install --target vendor' 2018-08-26 14:37:17 +07:00
templates Refactor: Provision calibre-web settings 2018-08-26 14:30:38 +07:00
README.rst Correct Variables and add tasks for future 2018-08-16 14:49:34 +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

When a configuration is not found calibre-web uses its default administration credentials.

 Username: admin

 Password: admin123


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.

The default database path is /library/calibre-web/

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.