Skip to main content

Install

XCON Quee ships as a Debian/Ubuntu package from the signed apt repository at apt.xcon-q.com.

curl -fsSL https://apt.xcon-q.com/install.sh | sudo sh

The installer is idempotent (safe to re-run). It trusts the repository signing key, adds the source, and installs the xcon-quee package — a static /usr/bin/xcon-quee, a xcon-quee.service systemd unit, and a quee system user whose state lives in /etc/xcon-quee.

First-run setup​

On first boot with no config, the broker serves an install wizard on :9080. A one-time setup key gates it (loopback is exempt — reach the wizard over an SSH tunnel and no key is needed). The key is printed by the installer and kept in /etc/xcon-quee/setup-token; it disappears once setup completes.

http://<server-ip>:9080/?key=<setup-key>

The wizard asks for a reachable xcon-db engine — XCON Quee keeps all of its durable state there. No engine yet? Install one first: https://docs.xcon-db.com/guide/install/. The wizard writes /etc/xcon-quee/xcon-quee.json and sets the first admin login.

The AMQP surface​

The AMQP 0-9-1 listener is opt-in. Enable it by adding an amqp_listen address to the config and restarting:

{
  "listen": "0.0.0.0:9080",
  "engine": { "addr": "127.0.0.1:5432", "user": "xcon", "db": "main" },
  "amqp_listen": "0.0.0.0:5672"
}

Service​

systemctl status xcon-quee
journalctl -u xcon-quee -f