Deployment topologies

A Reemo instance can be deployed in several shapes, from a single server to a cluster spread across multiple sites. The topology depends on the target availability level and the network isolation requirements.

Single server or cluster

  • Single server: all micro-services on one machine. Simple installation, suited to testing and small use cases.

  • High-availability cluster: at least 3 servers, on Docker Swarm, for resilience. On the INFRA side, the cluster is made up of Manager nodes only.

INFRA separation (DMZ)

INFRA is not necessarily monolithic. In multi-cluster (DMZ) mode, its roles are split across two zones:

  • Portal server (DMZ): Traefik, Portal, Signal, and an HAProxy proxy to the API — exposed to the Internet.

  • API server (internal): API, provisioning and relay services, CRON tasks, and the database — unreachable from the Internet.

This separation places the web front ends in the exposed zone and keeps the API core in the internal zone.

Dedicated or colocated environments

The provision environments and relays run on the core or on dedicated machines:

  • PROVISION: colocated, or with managers separated from workers for isolation needs.

  • TURN: colocated on the INFRA cluster, or dedicated (turn_manager inventory group) on a separate Swarm. Up to two servers can be declared for redundancy.

  • RELAYWS: a Swarm cluster of Manager nodes, with one relay created per connection.

  • APPLIANCE: outbound-only provision — a bridge initiates an outbound WebSocket connection to the Reemo infrastructure, with no inbound opening toward the network that hosts the containers.

Bi-site deployment (active/active)

Two independent sites each host a complete instance (portal, API, database). There is no replication of database or sessions between the sites: access consistency relies on a single shared SAML identity provider. Traffic is spread across sites by external DNS (round-robin, GSLB, or geolocation).

See also

Bi-site deployment — Setting up two active/active sites.

See also

Environments — An instance’s environments and how they are distributed.

See also

INFRA Environment — Simple cluster and multi-cluster (DMZ) deployment modes.

See also

TURN — Colocated or dedicated deployment of the media relay.