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 3ba87e57dc Settings 'app.db' destination folder is enough
This prevents the bug where 'app.db' was copied twice.
2018-08-27 16:39:12 +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 Settings 'app.db' destination folder is enough 2018-08-27 16:39:12 +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.