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
Arky f8c50aa589 Ansible Systemd doesn't have graceful reload available.
According to Ansible developers, there is no feature to do graceful
restart either in ansible systemd or in other Ansible apache modules.
2018-08-27 16:41:43 +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 Ansible Systemd doesn't have graceful reload available. 2018-08-27 16:41:43 +07:00
templates Refactor: Simpler Calibre-web service 2018-08-26 23:12:53 +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.