2. Execute the command: `python cps.py` (or `nohup python cps.py` - recommended if you want to exit the terminal window)
2. Execute the command: `python cps.py` (or `nohup python cps.py` - recommended if you want to exit the terminal window)
3. Point your browser to `http://localhost:8083` or `http://localhost:8083/opds` for the OPDS catalog
3. Point your browser to `http://localhost:8083` or `http://localhost:8083/opds` for the OPDS catalog
4. Set `Location of Calibre database` to the path of the folder where your Calibre library (metadata.db) lives, push "submit" button
4. Set `Location of Calibre database` to the path of the folder where your Calibre library (metadata.db) lives, push "submit" button
@ -41,6 +41,9 @@ Calibre-Web is a web app providing a clean interface for browsing, reading and d
*Username:* admin
*Username:* admin
*Password:* admin123
*Password:* admin123
**Issues with Ubuntu:**
Please note that running the above install command can fail on some versions of Ubuntu, saying `"can't combine user with prefix"`. This is a [known bug](https://github.com/pypa/pip/issues/3826) and can be remedied by using the command `pip install --system --target vendor -r requirements.txt` instead.
## Runtime Configuration Options
## Runtime Configuration Options
The configuration can be changed as admin in the admin panel under "Configuration"
The configuration can be changed as admin in the admin panel under "Configuration"
@ -48,14 +51,14 @@ The configuration can be changed as admin in the admin panel under "Configuratio
Server Port:
Server Port:
Changes the port Calibre-Web is listening, changes take effect after pressing submit button
Changes the port Calibre-Web is listening, changes take effect after pressing submit button
Enable public registration:
Enable public registration:
Tick to enable public user registration.
Tick to enable public user registration.
Enable anonymous browsing:
Enable anonymous browsing:
Tick to allow not logged in users to browse the catalog, anonymous user permissions can be set as admin ("Guest" user)
Tick to allow not logged in users to browse the catalog, anonymous user permissions can be set as admin ("Guest" user)
Enable uploading:
Enable uploading:
Tick to enable uploading of PDF, epub, FB2. This requires the imagemagick library to be installed.
Tick to enable uploading of PDF, epub, FB2. This requires the imagemagick library to be installed.
Enable remote login ("magic link"):
Enable remote login ("magic link"):
Tick to enable remote login, i.e. a link that allows user to log in via a different device.
Tick to enable remote login, i.e. a link that allows user to log in via a different device.
@ -83,7 +86,7 @@ Once a project has been created, we need to create a client ID and a client secr
5. Select Web Application and then next
5. Select Web Application and then next
6. Give the Credentials a name and enter your callback, which will be CALIBRE_WEB_URL/gdrive/callback
6. Give the Credentials a name and enter your callback, which will be CALIBRE_WEB_URL/gdrive/callback
7. Click save
7. Click save
8. Download json file and place it in `calibre-web` directory, with the name `client_secrets.json`
8. Download json file and place it in `calibre-web` directory, with the name `client_secrets.json`
The Drive API should now be setup and ready to use, so we need to integrate it into Calibre-Web. This is done as below: -
The Drive API should now be setup and ready to use, so we need to integrate it into Calibre-Web. This is done as below: -
@ -103,7 +106,7 @@ Additionally the public adress your server uses (e.g.https://example.com) has to
9. Open config page
9. Open config page
10. Click enable watch of metadata.db
10. Click enable watch of metadata.db
11. Note that this expires after a week, so will need to be manually refresh
11. Note that this expires after a week, so will need to be manually refresh
For configuration of calibre-web as SSL Server go to the Config page in the Admin section. Enter the certfile- and keyfile-location, optionally change port to 443 and press submit.
For configuration of calibre-web as SSL Server go to the Config page in the Admin section. Enter the certfile- and keyfile-location, optionally change port to 443 and press submit.
Afterwards the server can only be accessed via SSL. In case of a misconfiguration (wrong/invalid files) both files can be overridden via command line options
Afterwards the server can only be accessed via SSL. In case of a misconfiguration (wrong/invalid files) both files can be overridden via command line options
-c [certfile location] -k [keyfile location]
-c [certfile location] -k [keyfile location]
By using "" as file locations the server runs as non SSL server again. The correct file path can than be entered on the Config page. After the next restart without command line options the changed file paths are applied.
By using "" as file locations the server runs as non SSL server again. The correct file path can than be entered on the Config page. After the next restart without command line options the changed file paths are applied.
@ -206,7 +209,7 @@ enables the service.
Starting the script with `-h` lists all supported command line options
Starting the script with `-h` lists all supported command line options
Currently supported are 2 options, which are both useful for running multiple instances of Calibre-Web
Currently supported are 2 options, which are both useful for running multiple instances of Calibre-Web
`"-p path"` allows to specify the location of the settings database
`"-p path"` allows to specify the location of the settings database
`"-g path"` allows to specify the location of the google-drive database
`"-g path"` allows to specify the location of the google-drive database
`"-c path"` allows to specify the location of SSL certfile, works only in combination with keyfile
`"-c path"` allows to specify the location of SSL certfile, works only in combination with keyfile
`"-k path"` allows to specify the location of SSL keyfile, works only in combination with certfile
`"-k path"` allows to specify the location of SSL keyfile, works only in combination with certfile