History

Ginger f1e3b4907e All checks were successful Documentation / Build and Deploy Documentation (push) Successful in 48s Details Checks / Prek / Pre-commit & Formatting (push) Successful in 1m6s Details Release Docker Image / Build linux-amd64 (release) (push) Successful in 4m56s Details Release Docker Image / Build linux-arm64 (release) (push) Successful in 5m11s Details Checks / Prek / Clippy and Cargo Tests (push) Successful in 7m5s Details Release Docker Image / Create Multi-arch Release Manifest (push) Successful in 12s Details Release Docker Image / Build linux-arm64 (max-perf) (push) Successful in 12m14s Details Release Docker Image / Build linux-amd64 (max-perf) (push) Successful in 12m21s Details Release Docker Image / Create Max-Perf Manifest (push) Successful in 9s Details Build Debian packages and upload them to Forgejo's repository (#996 ) This uses the existing `cargo-deb` metadata. Reviewed-on: #996 Reviewed-by: Tom Foster <tom@tcpip.uk> Reviewed-by: nex <nex@noreply.forgejo.ellis.link> Co-authored-by: Ginger <ginger@gingershaped.computer> Co-committed-by: Ginger <ginger@gingershaped.computer>		2025-09-23 19:53:37 +00:00
..
config	fix: Move packaging files from `dist/` to `pkg/`	2025-09-06 14:03:57 +00:00
postinst	fix: Move packaging files from `dist/` to `pkg/`	2025-09-06 14:03:57 +00:00
postrm	fix: Move packaging files from `dist/` to `pkg/`	2025-09-06 14:03:57 +00:00
README.md	Build Debian packages and upload them to Forgejo's repository (#996 )	2025-09-23 19:53:37 +00:00

README.md

Continuwuity for Debian

This document provides information about downloading and deploying the Debian package. You can also use this guide for other deb-based distributions such as Ubuntu.

Installation

To add the Continuwuation apt repository:

# Replace with `"dev"` for bleeding-edge builds at your own risk
export COMPONENT="stable"
# Import the Continuwuation signing key
sudo curl https://forgejo.ellis.link/api/packages/continuwuation/debian/repository.key -o /etc/apt/keyrings/forgejo-continuwuation.asc
# Add a new apt source list pointing to the repository
echo "deb [signed-by=/etc/apt/keyrings/forgejo-continuwuation.asc] https://forgejo.ellis.link/api/packages/continuwuation/debian $(lsb_release -sc) $COMPONENT" | sudo tee /etc/apt/sources.list.d/continuwuation.list
# Update remote package lists
sudo apt update

To install continuwuity:

sudo apt install continuwuity

The continuwuity package conflicts with the old conduwuit package and will remove it automatically when installed.

See the generic deployment guide for additional information about using the Debian package.

Configuration

After installation, Continuwuity places the example configuration at /etc/conduwuit/conduwuit.toml as the default configuration file. The configuration file indicates which settings you must change before starting the service.

You can customize additional settings by uncommenting and modifying the configuration options in /etc/conduwuit/conduwuit.toml.

Running

The package uses the conduwuit.service systemd unit file to start and stop Continuwuity. The binary installs at /usr/bin/conduwuit.

By default, this package assumes that Continuwuity runs behind a reverse proxy. The default configuration options apply (listening on localhost and TCP port 6167). Matrix federation requires a valid domain name and TLS. To federate properly, you must set up TLS certificates and certificate renewal.

For information about setting up a reverse proxy and TLS, consult online documentation and guides. The generic deployment guide documents Caddy, which is the most user-friendly option for reverse proxy configuration.