About this article
This article covers the installation of Calibre within the QuickBox environment. If you are unsure about what Calibre is, or if you are not sure it fits your needs, please refer to the Calibre Quick Reference article for links and more about what Calibre aims to achieve.
Install Calibre from the Dashboard
- Login to your Dashboard at
https://SERVERIP(or)DOMAIN/login.php - Navigate to your Apps Dashboard and click on the Application Management tab.
- Click on the Install button for Calibre.
- You’re done! Once the install completes the page will reload with the relevant entries on your Dashboard.
Install Calibre from CLI
- Login to your server via ssh.
- Once logged into your server type
sudo su -orsudo -ifollowed by hitting enter on your keyboard. This properly elevates your bash environment for runningqbcommands. - Once your bash is elevated you can now type
qb install calibre USERNAME(where USERNAME is your actual username within your QuickBox install). - You’re done! On completion the relevant information for ports and access link will be posted.
After installing Calibre
It is advised as best practice to set up the built-in Authentication within any applications that offer them. As a courtesy, the QuickBox install will stage standard browser based authentication until this is done, once an applications provided Authentication is setup the provided browser authentication by QuickBox can be easily disabled.
Set up Authentication
Once you have Calibre installed you will want to login and set up the provided Authentication for added security.
As a default Calibre will stage a temporary username (admin) and password (admin123). It is advised to change these default values.
On first access to Calibre you will be prompted to set the location of your Calibre Database. Enter in /home/USERNAME/calibre/library and click the Save button. This will apply your changes and save the location. Now follow the steps outlined below to setup authentication in the Calibre application.
- After saving your Calibre database location you can now navigate to your Admin’s profile by clicking the admin profile icon in the top right corner.
- Enter your desired username and password (these details do not have to be the same as your QuickBox credentials, however, best practice is to at least make the password different)
- Note that the default username will be set as admin. It is preferred to set this as the username of your current QuickBox user installing Calibre.
- All other fields such as email address, send to kindle email address, and subsequent options listed within the checkboxes presented are based on your preferences and are optional.
- Click the Save button to apply and save your changes.
