mirror of
https://github.com/iiab/iiab.git
synced 2025-02-14 20:22:08 +00:00
| .. | ||
| defaults | ||
| files | ||
| tasks | ||
| templates | ||
| README.rst | ||
================== Calibre-Web README ================== Calibre-Web server provides a clean interface for browsing, reading and downloading e-books using an existing Calibre database. This Ansible role installs Calibre-Web in Internet-in-a-Box (we'll call it 'calibre-web' from here on down, noting that calibreweb_* variables do not include the dash, per Ansible recommendations.) Access ------ After installation you can access calibre-web at http://box/calibre-web (in future we may consider http://box/books). Log in with administrative account: Username: Admin Password: changeme If the default configuration is not found, calibre-web server creates a new settings file with calibre-web's own default administrative account: Username: admin Password: admin123 Backend ------- You can manage the backend calibre-web server manually with these commands: systemctl enable calibre-web systemctl restart calibre-web systemctl status calibre-web systemctl stop calibre-web Configuration ------------- To configure calibre-web, login as user 'Admin' then click on 'Admin' panel on top. See 'Configuration' options near the bottom of the page. Critical settings are stored in: /library/calibre-web/config/app.db Your e-book metadata is stored in a Calibre-style database: /library/calibre-web/metadata.db See also: /library/calibre-web/metadata_db_prefs_backup.json Back Up Your Content -------------------- Please back up the entire folder ``/library/calibre-web`` before upgrading -- as it contains your calibre-web content **and** settings! Upgrading --------- Reinstalling calibre-web automatically upgrades to the latest version. Back up your content **and** settings before reinstalling, as explained above. **Move your /library/calibre-web/metadata.db if you're sure you want to install a bare/minimal metadata.db and force default settings. Then run:** cd /opt/iiab/iiab ./runrole calibre-web Or, to reinstall all of Internet-in-a-Box: cd /opt/iiab/iiab ./iiab-install --reinstall Or, if you just want to upgrade calibre-web code alone, prior to proceeding manually: cd /opt/iiab/calibre-web git pull Known Issues ------------ Trying to access an empty public bookshelf causes a system error. As of August 2018, calibre-web doesn't include Calibre's e-book conversion functionality (Calibre itself allows teachers to convert between PDF, epub, txt etc — to permit reading on a wider array client devices and client software).