Build and expand an X2 cluster

Install the first cluster node

Choose the server operating system, configure durable object and metadata paths, create the bootstrap administrator, and start the native service. Confirm readiness before enrolling another machine.

Create a Cluster Join Link

Sign in to an existing node as a system administrator, open Nodes, select Install New Node, and enter the new node's stable name, private IP address, and mesh port. X2 selects an available existing enrollment endpoint and returns one link.

x2join://<EXISTING_NODE_IP>:8443/X2J-7K9M-2QTX-G4NP-W8CR

The link is a temporary secret. It is bound to the requested node and mesh endpoint, limited to five enrollment attempts, usable by one node, and expires after 15 minutes. X2 verifies cluster trust during enrollment; the CA private key never leaves the issuer.

The public client URL is not used for enrollment.

Install the new node using the same guide

Follow the normal platform installation from download through service startup. At Configure this node, choose Join existing cluster and paste the link into Command Assist. The generated command adds --join-link; all other installation steps stay the same.

Verify cluster membership

The service enrolls, receives the current cluster state, and becomes available after catch-up and readiness checks finish.

Publish one client endpoint

After all intended nodes are ready, route public Console and S3 traffic through health-aware NGINX or HAProxy backends. Keep TCP 9443 mesh traffic private and direct between nodes.