macOS

A .pkg package that installs the server and registers it as a launchd daemon, started when the Mac boots.

Requirements #

  • An Apple Silicon Mac.
  • A reachable PostgreSQL 16 — it is not bundled in the package.

Installation #

  1. Download kubuno-core-<version>-arm64.pkg from the core's Releases page.
  2. Open it and follow the steps; the daemon is registered and started at the end.
  3. Open http://localhost:8080/ for the installation wizard.

Where the package installs what #

/usr/local/kubuno/{bin,frontend,migrations}    # the server
/etc/kubuno/config.toml                        # the configuration
/usr/local/var/kubuno/{files,logs,themes}      # the data
/Library/LaunchDaemons/com.kubuno.core.plist   # the daemon

Controlling the daemon #

sudo launchctl kickstart -k system/com.kubuno.core   # redémarrer
sudo launchctl print system/com.kubuno.core          # état
tail -f /usr/local/var/kubuno/logs/*.log             # journaux
Warning

The published package is neither signed nor notarised: macOS will block it on first launch. Allow it from System Settings → Privacy and Security, just after the attempt to open it.

Uninstalling #

No uninstaller is provided; removal is done by hand. None of these commands deletes your data or your configuration.

sudo launchctl bootout system /Library/LaunchDaemons/com.kubuno.core.plist
sudo rm /Library/LaunchDaemons/com.kubuno.core.plist
sudo rm -rf /usr/local/kubuno
Note

Of our four packages, this one is the least battle-tested: it is built at every version by continuous integration, but exercised in production far less than the Linux packages. For a server, prefer Linux or Docker.