Self-hosted · production installer

A supported path from a clean Linux host to the first call.

The installer validates the host before changing it, generates unique secrets, starts the production stack, applies migrations, checks HTTPS and optionally claims a paid license.

Stable channel online

The current production bundle, SHA-256 checksum and detached signature are published at downloads.relaypbx.com/stable. The installer verifies release integrity before changing the host and the Update Center uses the same signed channel.

01 · HOST

Supported platform and minimum

Use a dedicated x86_64 virtual machine or physical host. The enforced minimum is 2 vCPU, 4 GB RAM and a 40 GB disk with at least 32 GiB free after the operating system is installed.

  • Ubuntu Server 24.04 LTS or Debian 12
  • Static public IPv4 address
  • FQDN with an A record pointing to that address
  • Root or passwordless sudo during installation
  • Outbound HTTPS, DNS and NTP
  • No web server, SIP service or conflicting Docker stack
02 · INSTALL

Run the guided bootstrap

Generate a fresh one-time claim in the paid order. Omit the final line to install Community.

curl -fsSLO https://relaypbx.com/install-relaypbx.sh
chmod +x install-relaypbx.sh
sudo ./install-relaypbx.sh \
  --domain pbx.customer.example \
  --public-ip 203.0.113.10 \
  --claim-code 'PASTE-ONE-TIME-CODE'

Superadmin email and password are requested interactively and are not placed in shell history. The claim is redeemed only after the local health check succeeds.

03 · ACCEPT

Production acceptance is more than “containers are up”

  • Confirm panel HTTPS and license state.
  • Register two dedicated test extensions.
  • Prove two-way audio and remote BYE in both directions.
  • Test inbound, outbound and emergency routing policy.
  • Create a backup and restore it to an isolated clean host.
  • Run the SIP load profile sized for the purchased capacity.