Linux (.deb / .rpm)

The core packaged for your distribution: it installs like any other system software, registers as a systemd service and starts with the machine. This is the method for running Kubuno in earnest.

Requirements #

Debian or Ubuntu for the .deb; Fedora, RHEL or openSUSE for the .rpm.
A reachable PostgreSQL 16 — it is not bundled in the package. On the same machine or elsewhere, it makes no difference.
2 GB of RAM at the very least; 4 GB and above become comfortable as soon as you add modules.

Note

Neither Rust nor Node.js is required: the packages contain the server already built. Those tools are only needed to build from source.

1. Download the package #

From the core's Releases page, take the artefact in your format. The .deb name carries a build identifier (for example kubuno-core_0.1.7-42.g4c9618c_amd64.deb): the commands below therefore use a pattern rather than a fixed name.

https://github.com/kubuno/core/releases/latest

2. Install #

sudo apt install ./kubuno-core_*_amd64.deb

sudo dnf install ./kubuno-core-0.1.7-1.x86_64.rpm

sudo zypper install ./kubuno-core-0.1.7-1.x86_64.rpm

The package creates the kubuno service account, installs the systemd unit and starts the service.

3. Check the service #

sudo systemctl enable --now kubuno
systemctl status kubuno
journalctl -u kubuno -f

Then open http://<your-server>:8080/: the installation wizard takes over and writes the configuration for you.

Where the package installs what #

/usr/bin/kubuno-core                 # the server
/usr/bin/kubuno                      # the administration console
/usr/share/kubuno/frontend/          # the interface
/usr/share/kubuno/migrations/        # the SQL migrations
/etc/kubuno/config.toml              # the configuration
/usr/lib/kubuno/modules/<id>/        # the installed modules
/var/lib/kubuno/                     # data, themes, instance secrets
/var/backups/kubuno/                 # where your backups are meant to go
/var/log/kubuno/                     # the logs

Note

Three files in /var/lib/kubuno deserve your attention: data.key encrypts the stored secrets — back it up together with the database, for without it your backups would be unreadable; setup-token is the wizard's token, erased as soon as the installation is finished; initial-admin-password exists only if the server had to generate a password.

Updating #

Install the new version over the top: your configuration and your data are preserved.

sudo apt install ./kubuno-core_<nouvelle-version>_amd64.deb
sudo systemctl restart kubuno

sudo dnf upgrade ./kubuno-core-<nouvelle-version>.x86_64.rpm
sudo systemctl restart kubuno

Note

Installing several packages one after another can make systemd hit its restart limit (start-limit-hit). In that case: sudo systemctl reset-failed kubuno && sudo systemctl restart kubuno.

Uninstalling #

sudo apt remove kubuno-core      # keeps /etc/kubuno and /var/lib/kubuno
sudo apt purge  kubuno-core      # removes the configuration as well

sudo dnf remove kubuno-core      # the configuration is kept

Note

In every case, uninstalling keeps your configuration, your data, your logs, your backups and the PostgreSQL database. Truly starting from scratch means deleting them yourself.