This is the fast path to a running Binions on a single Linux host. Add the Binions package repository, authenticate with your licence, install a daemon, and start it — you can have a working service answering health checks in a few minutes. For multi-host, offline, or advanced setups, head to Installation.
Good to know. Binions installs with a familiar
apt installfrom a signed package repository. If you are comfortable with SSH and the command line, this guide is all you need to get started.
You need a Linux host and a Binions account. The free tier covers exactly what you need to try the platform end to end.
| Operating system | Linux x86_64 — Ubuntu 24.04 LTS or Debian 12+ |
| Tools | apt and curl (both standard on those systems) |
| Access | Root, or a user with sudo |
| Account | A Binions account and repository access — see Licensing & Purchase |
| Network | Outbound HTTPS to the Binions package repository |
Free to try. You can run one set on one host for free for non-commercial use — hobby, homelab, education, or evaluation. There is no card required; you just sign in and accept the licence terms. Commercial use, or a second host, needs a paid licence. See Licensing & Purchase for the details.
Run these on the host where Binions will live. We install the logger daemon first — it is the simplest service and a good way to confirm everything works before you add more.
Add the signed Binions package repository so apt can find and trust the packages. The exact repository line and signing-key command for your account are shown on your account page after sign-in — copy them from there. They set up two things: the public signing key under /etc/apt/keyrings/, and a source list at /etc/apt/sources.list.d/binions.list.
Why a signing key. Every Binions package is cryptographically signed. The key lets
aptverify that each package really comes from Binions and has not been tampered with in transit.
The repository is private to licensed users, so apt needs to identify itself. Authenticate with the access token from your account — your account page generates it and shows the exact one-line command to store it. The token ties downloads to your licence; keep it private. Step-by-step instructions, including where the token file lives, are in Installation.
Pull the latest package index from the repository:
sudo apt updateIf the repository and authentication are set up correctly, you will see an InRelease line for the Binions repository and no errors.
Install the logger daemon and enable it. Each Binions daemon ships with its own dedicated Redis instance for its event bus, so you start both together:
sudo apt install binions-logger
sudo systemctl enable --now binions-logger redis-binions-loggerThe package configures itself on install — it creates its own service user, directories, and configuration, so there is nothing to set up by hand for this first daemon.
Check that the service is active and answering its health endpoint:
systemctl is-active binions-logger
curl -sf http://127.0.0.1:9100/health/ready && echo OKYou should see active from the first command and OK from the second. That confirms the daemon is up and its event bus is reachable. To watch its event log, run journalctl -u binions-logger -n 20 --no-pager.
Heads up. This is the quick path for a single host. Multi-host deployments, offline or air-gapped installs, version pinning, per-daemon requirements, and the full prerequisites list all live in Installation. If a command above does not match what your account page shows, follow your account page — it always reflects the current, licence-specific steps.
Each capability is its own package, so you install only what you need. Add another daemon the same way — install the package, then enable it together with its Redis instance:
sudo apt install binions-mailbox
sudo systemctl enable --now binions-mailbox redis-binions-mailboxA few daemons depend on external services or credentials, which you set up before enabling them:
For the full daemon list and what each one needs, see Daemons, and for the exact setup steps see Installation.