HYDRILLA(1)

NAME
hydrilla - Serve packages for the Haketilo browser extension

SYNOPSIS
hydrilla --help
hydrilla [-m DIRECTORY] [-h URL] [-p PORT] [-l LANGUAGE]
[-c CONFIG]
(See the OPTIONS section for alternate option syntax with long option names.)

DESCRIPTION
hydrilla is a command to start the Hydrilla repository software that serves Haketilo packages over HTTP. The primary method of running Hydrilla server is through a WSGI script. hydrilla command should only be used in local or development deployments.

OPTIONS

--help
    Output a usage message and exit.

-m DIRECTORY, --malcontent-dir=DIRECTORY
    Look inside DIRECTORY for package files to serve. Use of the word “malcontent” is a pun on widespread use of word “content” (https://www.gnu.org/philosophy/words-to-avoid.en.html#Content) with regard to works published online. This option, if present, overrides the property “malcontent_dir” from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to “/var/lib/hydrilla/malcontent”.

-h URL, --hydrilla-project-url=URL
    Use URL when placing a link to Hydrilla website in served HTML pages. This option, if present, overrides the property “hydrilla_project_url” from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to “https://hydrillabugs.koszko.org/projects/hydrilla/wiki”.

-p PORT, --port=PORT
    Run the Hydrilla HTTP server on port PORT. If PORT is 0, let hydrilla choose a random free port on the machine. This option, if present, overrides the property “port” from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to 10112.

-l LANGUAGE, --language=LANGUAGE
    Generate all user messages (including those on served HTML pages) using locale LANGUAGE. LANGUAGE should be one of the locales supported by hydrilla, e.g. “en_US”. Otherwise, hydrilla will silently fall back to the en_US locale. This option, if present, overrides the property “language” from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to “en_US”.

-c CONFIG, --config=CONFIG
    Process the file at CONFIG as Hydrilla config file. CONFIG must exist in the filesystem and be readable to hydrilla. If this option is not given, hydrilla loads its own, internal config file that in turn tries to load /etc/hydrilla/config.json.

--version
    Show version information for this instance of hydrilla on the standard output and exit successfully.

EXIT STATUS
The exit status is 0 if the server was started successfully and terminated manually by the user (i.e. through delivery of a SIGINT signal) or if the --help option was passed. It is a number different from 0 if the server failed to start. Possible causes include invalid command line arguments, broken packages inside the provided DIRECTORY (may instead generate a warning message depending on the “werror” config file option), insufficient privileges to use the specified PORT and invalid or unreadable config file.

SEE ALSO

  Manual Pages
hydrilla-builder(1).

  Full Documentation
Online documentation (https://hydrillabugs.koszko.org/projects/hydrilla/wiki) is available on Hydrilla issue tracker.