calibre-server [options]

Start the calibre content server. The calibre content server exposes your calibre library over the internet. The default interface allows you to browse you calibre library by categories. You can also access an interface optimized for mobile browsers at /mobile and an OPDS based interface for use with reading applications at /opds.

The OPDS interface is advertised via BonJour automatically.

Whenever you pass arguments to calibre-server that have spaces in them, enclose the arguments in quotation marks. For example “C:some path with spaces”



Auto reload server when source code changes. May not work in all environments.


Run process in background as a daemon. No effect on windows.


Development mode. Server logs to stdout, with more verbose logging and has much lower timeouts.

--help, -h

show this help message and exit


The maximum size for displayed covers. Default is '600x800'.


The maximum number of matches to return per OPDS query. This affects Stanza, WordPlayer, etc. integration.


Group items in categories such as author/tags by first letter when there are more than this number of items. Default: 100. Set to a large number to disable grouping.


Set a password to restrict access. By default access is unrestricted.


Write process PID to the specified file

--port, -p

The port on which to listen. Default is 8080


Specifies a virtual library to be used for this invocation. This option overrides any per-library settings specified in the GUI. For compatibility, if the value is not a virtual library but is a saved search, that saved search is used. Also note that if you do not specify a restriction, the value specified in the GUI (if any) will be used.


The max number of worker threads to use. Default is 30

--timeout, -t

The server timeout in seconds. Default is 120


Prefix to prepend to all URLs. Useful for reverseproxying to this server from Apache/nginx/etc.


Username for access. By default, it is: 'calibre'


show program's version number and exit


Path to the library folder to serve with the content server