diff options
Diffstat (limited to 'system/kiwix-tools-bin/docs/man/kiwix-serve.1')
-rw-r--r-- | system/kiwix-tools-bin/docs/man/kiwix-serve.1 | 136 |
1 files changed, 136 insertions, 0 deletions
diff --git a/system/kiwix-tools-bin/docs/man/kiwix-serve.1 b/system/kiwix-tools-bin/docs/man/kiwix-serve.1 new file mode 100644 index 0000000000..69d86b462e --- /dev/null +++ b/system/kiwix-tools-bin/docs/man/kiwix-serve.1 @@ -0,0 +1,136 @@ +.TH KIWIX 1 "10 July 2023" + +.SH NAME +kiwix-serve \- Kiwix HTTP Server + +.SH SYNOPSIS + +.B kiwix-serve --library [OPTIONS] LIBRARY_FILE_PATH +.br +.B kiwix-serve [OPTIONS] ZIM_FILE_PATH ... + +.SH DESCRIPTION +The \fBkiwix-serve\fR command is used to run a stand-alone HTTP server for serving ZIM contents over the network. + +.SH ARGUMENTS +.TP +\fBLIBRARY_FILE_PATH\fR +Path of an XML library file listing ZIM files to serve. To be used only with the --library option. Multiple library files can be provided as a semicolon (;) separated list. + +.TP +\fBZIM_FILE_PATH ...\fR +ZIM file path(s). Multiple arguments are allowed. + +.SH OPTIONS +.TP +\fB--library\fR +By default, kiwix-serve expects a list of ZIM files as command line arguments. Providing the --library option tells kiwix-serve that the command line argument is rather a library XML file. + +.TP +\fB-i ADDR, --address=ADDR\fR +Listen only on this IP address. By default, the server listens on all available IP addresses. + +.TP +\fB-p PORT, --port=PORT\fR +TCP port on which to listen for HTTP requests (default: 80). + +.TP +\fB-r ROOT, --urlRootLocation=ROOT\fR +URL prefix on which the content should be made available (default: empty). + +.TP +\fB-d, --daemon\fR +Detach the HTTP server daemon from the main process. + +.TP +\fB-a PID, --attachToProcess=PID\fR +Exit when the process with id PID stops running. + +.TP +\fB-M, --monitorLibrary\fR +Monitor the XML library file and reload it automatically when it changes. + +Library reloading can be forced anytime by sending a SIGHUP signal to the +\*(lqkiwix-serve\*(rq process (this works regardless of the presence of the +\*(lq--monitorLibrary\*(rq/\*(lq-M\*(rq option). + +.TP +\fB-m, --nolibrarybutton\fR +Disable the library home button in the ZIM viewer toolbar. + +.TP +\fB-n, --nosearchbar\fR +Disable the search box in the ZIM viewer toolbar. + +.TP +\fB-b, --blockexternal\fR +Prevent users from directly navigating to external resources via links in ZIM content. + +.TP +\fB-t N, --threads=N\fR +Number of threads to run in parallel (default: 4). + +.TP +\fB-s N, --searchLimit=N\fR +Maximum number of ZIM files in a fulltext multizim search (default: No limit). + +.TP +\fB-z, --nodatealiases\fR +Create URL aliases for each content by removing the date embedded in the file name. + +The expected format of the date in the filename is \*(lq_YYYY-MM\*(rq. For example, a ZIM file named \*(lqwikipedia_en_all_2020-08.zim\*(rq will be accessible both as \*(lqwikipedia_en_all_2020-08\*(rq and \*(lqwikipedia_en_all\*(rq. + +.TP +\fB-c PATH, --customIndex=PATH\fR +Override the welcome page with a custom HTML file. + +.TP +\fB-L N, --ipConnectionLimit=N\fR +Max number of (concurrent) connections per IP (default: infinite, recommended: >= 6). + +.TP +\fB-k, --skipInvalid\fR +Startup even when ZIM files are invalid (those will be skipped) + +.TP +\fB-v, --verbose\fR +Print debug log to STDOUT. + +.TP +\fB-V, --version\fR +Print the software version. + +.TP +\fB-h, --help\fR +Print a help message. + +.SH EXAMPLES +Serve a single ZIM file: +.sp +.nf +.B kiwix-serve myzim.zim +.fi + +Serve multiple ZIM files: +.sp +.nf +.B kiwix-serve zim1.zim zim2.zim zim3.zim +.fi + +Serve ZIM files from a library: +.sp +.nf +.B kiwix-serve --library library.xml +.fi + +.SH DOCUMENTATION +Online documentation: https://kiwix-tools.readthedocs.io/en/latest/kiwix-serve.html +.br +Source code: https://github.com/kiwix/kiwix-tools +.br +More info: https://wiki.kiwix.org/wiki/Kiwix-serve + +.SH AUTHORS +Emmanuel Engelhart <kelson@kiwix.org> +.br +Vasudev Kamath <kamathvasudev@gmail.com> |