2024-05-09 01:26:05 +00:00
|
|
|
# conduwuit for Debian
|
2020-11-13 19:50:58 +00:00
|
|
|
|
2023-07-23 10:34:48 +00:00
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
Information about downloading, building and deploying the Debian package, see
|
2024-04-25 04:09:50 +00:00
|
|
|
the "Installing conduwuit" section in the Deploying docs.
|
2023-07-23 10:34:48 +00:00
|
|
|
All following sections until "Setting up the Reverse Proxy" be ignored because
|
|
|
|
|
this is handled automatically by the packaging.
|
|
|
|
|
|
2020-11-13 19:50:58 +00:00
|
|
|
Configuration
|
|
|
|
|
-------------
|
|
|
|
|
|
2021-04-16 20:10:07 +00:00
|
|
|
When installed, Debconf generates the configuration of the homeserver
|
|
|
|
|
(host)name, the address and port it listens on. This configuration ends up in
|
2024-04-25 04:09:50 +00:00
|
|
|
`/etc/conduwuit/conduwuit.toml`.
|
2020-11-13 19:50:58 +00:00
|
|
|
|
|
|
|
|
You can tweak more detailed settings by uncommenting and setting the variables
|
2024-04-25 04:09:50 +00:00
|
|
|
in `/etc/conduwuit/conduwuit.toml`. This involves settings such as the maximum
|
2021-04-16 20:10:07 +00:00
|
|
|
file size for download/upload, enabling federation, etc.
|
2020-11-13 19:50:58 +00:00
|
|
|
|
|
|
|
|
Running
|
|
|
|
|
-------
|
|
|
|
|
|
2024-05-12 03:53:42 +00:00
|
|
|
The package uses the [`conduwuit.service`](../configuration.md#example-systemd-unit-file) systemd unit file to start and
|
2024-04-25 04:09:50 +00:00
|
|
|
stop conduwuit. It loads the configuration file mentioned above to set up the
|
2020-11-13 19:50:58 +00:00
|
|
|
environment before running the server.
|
|
|
|
|
|
2024-04-25 04:09:50 +00:00
|
|
|
This package assumes by default that conduwuit will be placed behind a reverse
|
|
|
|
|
proxy. This default deployment entails just listening
|
2023-07-23 10:24:37 +00:00
|
|
|
on `127.0.0.1` and the free port `6167` and is reachable via a client using the URL
|
2024-04-25 04:09:50 +00:00
|
|
|
<http://localhost:6167>. Matrix federation requires TLS, so you will need to set up
|
|
|
|
|
some certificates and renewal, for it to work properly.
|
