Skip to content
Fluxer API

Self-hosting

rexctl installs Fluxer on one machine and keeps it running. To run Fluxer on a Kubernetes cluster, use the Helm chart.

What you need

Section titled “What you need”
  • A 64-bit Linux, macOS or Windows machine with at least 2 CPU cores, 4 GB of memory and 20 GB of free disk space. That’s enough for about 1,000 people online at the same time. rexctl sizes Fluxer to the machine’s memory and CPUs every time it starts, so a bigger machine needs no extra settings.
  • On macOS and Windows, Docker Desktop. On Linux, rexctl installs Docker for you if it’s missing.
  • A domain or subdomain for your instance, such as chat.example.com.
  • An A record for that domain pointing to the machine’s public IP address. rexctl checks it before it asks for a certificate.

Open TCP ports 80, 443 and 7881 and UDP ports 443 and 7882 in any firewall outside the machine, such as your hosting provider’s firewall. On a home network, forward the same ports from your router to the machine. rexctl can open them in the machine’s own firewall for you.

Install

Section titled “Install”

On Linux or macOS:

Terminal window
curl -fsSL https://fluxer.dev/install.sh | sh

On Windows, run this in PowerShell:

Terminal window
irm https://fluxer.dev/install.ps1 | iex

The script downloads rexctl and starts it. Answer its questions, and when it’s done, rexctl prints your instance’s address.

rexctl asks where you want to create your admin account. “Here in the terminal” creates it during the install. “In my browser” prints a setup token at the end, and your instance asks for that token the first time you open it. If you lose the token, run rexctl setup token to show it again.

Once you’ve created the admin account, people can open your instance’s address in a browser or enter it in the desktop and mobile apps.

After you install

Section titled “After you install”

Once your instance is running, these pages help you look after it.

If you get stuck, ask in Fluxer Developers or open an issue on GitHub.