AZORIUS(8) | System Manager's Manual | AZORIUS(8) |
azorius
—
azorius
daemon processes messages from other
federated servers. This is the admin manual. For user operation, see
azorius(1).
azorius
can listen on TCP or
unix sockets, but will not terminate TLS. https is a required component for
federation. Also, http signature verification requires accurate time keeping.
Make sure to pass the Host header, if necessary (as for nginx).
proxy_set_header Host $http_host;
azorius
requires a go compiler 1.18 and
libsqlite. On OpenBSD this is the go and sqlite3
packages. Other platforms may require additional development libraries or
headers to be installed, such as gcc or cc. Run make. Please be patient. Even
on fast machines, building from source can take several seconds.
azorius
looks for
data.
-datadir
dir-viewdir
dirThe following options control log output. Acceptable values include "stderr" (the default), "stdout", "null", "syslog", or a file name. syslog messages will be sent to the NEWS facility.
init
command. This will create the database and
ask four questions, as well as creating the initial user.
upgrade
command. Restart.
The current version of the azorius binary may be printed with the
version
command.
azorius
is not currently hardened against SSRF, server
side request forgery. Be mindful of what other services may be exposed via
localhost or the local network.
devel
on|off. In devel mode,
secure cookies are disabled, TLS certs are not verified, and templates are
reloaded every request.
setconfig
key value command. For
example, to increase the fast timeout value from 5 seconds to 10:
./azorius setconfig fasttimeout
10
azorius
files are split between the data directory and
the view directory. Both default to "." but may be specified by
command line options.
The data directory contains:
The view directory contains:
azorius-v98> make azorius-v98> ./azorius -datadir ../azorius-data init listen address: /var/www/azorius.sock server name: azorius.example.com username: puffy password: OxychromaticBlowfishSwatDynamite azorius-v98> ./azorius -datadir ../azorius-data admin azorius-v98> date; ./azorius -log azorius.log -datadir ../azorius-data
Upgrade to the next version.
azorius-data> cp azorius.db backup.db azorius-data> cd ../azorius-v99 azorius-v99> make azorius-v99> ./azorius -datadir ../azorius-data upgrade azorius-v99> ./azorius -datadir ../azorius-data cleanup azorius-v99> date; ./azorius -log azorius.log -datadir ../azorius-data
August 29, 2023 | Debian |