.\" SPDX-License-Identifier: CC0-1.0
.\"
.\" Man page for Hydrilla server.
.\"
.\" Copyright (C) 2022 Wojtek Kosior <koszko@koszko.org>
.\"
.\" Available under the terms of Creative Commons Zero v1.0 Universal.

.TH HYDRILLA 1 2022-04-22 "Hydrilla 1.0" "Hydrilla Manual"

.SH NAME
hydrilla \- Serve packages for the Haketilo browser extension

.SH SYNOPSIS
.B "hydrilla \-\-help"
.br
.B "hydrilla [\-m \fIDIRECTORY\/\fP] [\-h\ \fIURL\/\fP]"
.B "[\-p\ \fIPORT\/\fP] [\-l \fILANGUAGE\/\fP]"
.br
.B "         [\-c \fICONFIG\/\fP]"
.br
(See the OPTIONS section for alternate option syntax with long option
names.)

.SH DESCRIPTION
.I 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.
.I hydrilla
command should only be used in local or development deployments.

.SH OPTIONS
.TP
.B \-\^\-help
Output a usage message and exit.

.TP
.BI \-m " DIRECTORY" "\fR,\fP \-\^\-malcontent\-dir=" DIRECTORY
Look inside
.I DIRECTORY
for package files to serve. Use of the word \*(lqmalcontent\*(rq is a
pun on widespread use of word
.UR https://www.gnu.org/philosophy/words-to-avoid.en.html#Content
\*(lqcontent\*(rq
.UE
with regard to works published online.

This option, if present, overrides the property \*(lqmalcontent_dir\*(rq from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to \%\*(lq/var/lib/hydrilla/malcontent\*(rq.

.TP
.BI \-h " URL" "\fR,\fP \-\^\-hydrilla\-project\-url=" URL
Use
.I URL
when placing a link to Hydrilla website in served HTML pages.

This option, if present, overrides the property \*(lqhydrilla_project_url\*(rq from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to \%\*(lqhttps://hydrillabugs.koszko.org/projects/hydrilla/wiki\*(rq.

.TP
.BI \-p " PORT" "\fR,\fP \-\^\-port=" PORT
Run the Hydrilla HTTP server on port
.IR PORT .
If
.I PORT
is 0, let
.I hydrilla
choose a random free port on the machine.

This option, if present, overrides the property \*(lqport\*(rq from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to 10112.

.TP
.BI  \-l " LANGUAGE" "\fR,\fP \-\^\-language=" LANGUAGE
Generate all user messages (including those on served HTML pages) using
locale
.IR LANGUAGE .

.I LANGUAGE
should be one of the locales supported by
.IR hydrilla ,
e.g. \*(lqen_US\*(rq.
Otherwise,
.I hydrilla
will silently fall back to the en_US locale.

This option, if present, overrides the property \*(lqlanguage\*(rq from Hydrilla config file. If the value is not specified on the command line nor in the config file, it defaults to \*(lqen_US\*(rq.

.TP
.BI \-c " CONFIG" "\fR,\fP \-\^\-config=" CONFIG
Process the file at
.I CONFIG
as Hydrilla config file.
.I CONFIG
must exist in the filesystem and be readable to
.IR hydrilla .

If this option is not given,
.I hydrilla
loads its own, internal config file that in turn tries to load
\%/etc/hydrilla/config.json.

.TP
.B \-\^\-version
Show version information for this instance of
.I hydrilla
on the standard output and exit successfully.

.SH "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
.B \-\^\-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
.I DIRECTORY
(may instead generate a warning message depending on the \*(lqwerror\*(rq
config file option),
.\"
insufficient privileges to use the specified
.I PORT
and
.\"
invalid or unreadable config file.

.SH "SEE ALSO"
.SS "Manual Pages"
.BR hydrilla-builder (1).

.SS "Full Documentation"
.UR https://hydrillabugs.koszko.org/projects/hydrilla/wiki
Online documentation
.UE
is available on Hydrilla issue tracker.
ertbot: Allow to set RSA key size.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:53 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=c3215d2f9d8fa4b890e3a41ceb4404b76a7c5c49'>services: certbot: Associate one certificate with several domains.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:53 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=65fc1d890d2e33e62a7c9d9fe31184c48d848e0c'>services: certbot: Get certbot to run non-interactively.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:53 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=c1dfcfdf58b4a05903d6b4266ca3c04f1c4cb6e2'>services: certbot: Refactor certbot command.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:53 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=966fd7b7e9f321a02e740659ab1c1853e34533b5'>services: certbot: Rename 'host' to 'domain'.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:53 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=301518638fbb2344b523623317bb5cd084e80d44'>services: certbot: Fix indentation.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:52 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=7ab04c17c01a926660cd1c9fa9311a5efc6716da'>services: certbot: Run certbot twice a day at a random minute.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2018-02-22 21:43:52 +0100'>2018-02-22</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=70cd2239a567fe551bdbe368b1d2b9d9cf531d09'>services: certbot: Listen on IPv6.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2017-12-18 12:03:14 +0100'>2017-12-18</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=8b223ceac4ff0781e95d69362875f87cff03f4d6'>services: nginx: Replace 'http-port' and 'https-port' with 'listen'.</a><span class='msg-avail'>...</span></td><td>Clément Lassieur</td></tr>
<tr><td><span title='2017-12-17 20:37:12 +0000'>2017-12-17</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=e8a051ee7c140886bce8dcd191cb10918b2d4078'>services: certbot: Fix certbot renewal job.</a><span class='msg-avail'>...</span></td><td>Christopher Baines</td></tr>
<tr><td><span title='2017-11-28 23:34:25 +0100'>2017-11-28</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=3af03e5967cf49ed1a4382dad7d75daa95ec5217'>services: certbot: Add default value and description.</a><span class='msg-avail'>...</span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2017-11-28 23:34:24 +0100'>2017-11-28</span></td><td><a href='/guix/commit/gnu/services/certbot.scm?id=1115f140179b8fafb5a0f7c91a22dfdb7d6b21cc'>services: Add certbot service.</a><span class='msg-avail'>...</span></td><td>Andy Wingo</td></tr>