Matrix
Forgejo
Open Collective

    RPM Installation Guide

    Overview

    Continuwuity versions v0.5.10+ are available as RPM packages for the following distributions:

    Fedora
    EL
    SUSE

    Available for upstream-supported Fedora versions (including compatible distributions, such as Ultramarine Linux) and Rawhide through Terra.

    Installation methods

    Stable releases

    Fedora
    EL
    SUSE
    1. Follow Terra's directions for adding the Terra repo on your distribution.
    2. Install the continuwuity package.

    Nightly releases

    Nightly versions are built from the latest commit on the main branch every 24 hours.

    Fedora
    EL
    SUSE
    1. Follow Terra's directions for adding the Terra repo on your distribution.
    2. Install the continuwuity-nightly package.

    Configuration

    Consult the generic deployment instructions for detailed steps. You will at least need to adjust the config file located at /etc/conduwuit/conduwuit.toml to suit your needs, and configure a reverse proxy.

    Service management

    Now, you can start your Continuwuity service with:

    # Start the service
sudo systemctl start conduwuit

    Other useful commands include:

    # Enable on boot
sudo systemctl enable conduwuit

# Check status
sudo systemctl status conduwuit

# View logs
sudo journalctl -u conduwuit -f

# Stopping the service
sudo systemctl stop conduwuit

    Troubleshooting

    Repository metadata issues: Clear and rebuild cache

    sudo dnf clean all
sudo dnf makecache

    Finding specific versions

    # List all available versions
dnf --showduplicates list continuwuity

# Install a specific version
sudo dnf install continuwuity-<version>

    What's next?

    Navigate to Post-installation for next steps.

    Appendix

    Uninstallation

    To uninstall Continuwuity:

    # Stop and disable the service
sudo systemctl stop conduwuit
sudo systemctl disable conduwuit

# Remove the package
sudo dnf remove continuwuity # replace `dnf` with `zypper` on openSUSE

    Building locally

    Fedora
    EL
    SUSE
    Directly from Continuwuity source

    Build the RPM locally using rpkg:

    # Install dependencies
sudo dnf install rpkg rpm-build cargo-rpm-macros systemd-rpm-macros

# Clone the repository
git clone https://forgejo.ellis.link/continuwuation/continuwuity.git
cd continuwuity

# Build SRPM
rpkg srpm

# Build RPM
rpmbuild --rebuild *.src.rpm

    Or, use Terra:

    1. Follow Terra's prep directions to bootstrap your development environment.
    2. git clone the Terra sources repo.
    3. Follow Terra's build instructions, using the path anda/misc/continuwuity/nightly/pkg. If desiring a build of the latest stable version, replace nightly with stable instead.