Failed to Install 'Database' Role
Error: An unknown error occurred, please try again later or a generic Failed status during database role deployment.
This failure usually occurs when the LxRoot installer attempts to verify the database cluster's health but is blocked by the server's own networking configuration.
The NAT & Hairpin Requirement
If your server is located behind a NAT (Network Address Translation) gateway—common in cloud environments like AWS, GCP, or private data centers—you must ensure that Hairpin NAT (also known as NAT Loopback) is enabled.
Critical Connectivity Test
The server must be able to reach its own Public IP on the following port:
Protocol: TCP
Why this is necessary:
During the database role installation, the orchestration agent attempts to connect to the cluster management API using the server's public-facing identity. If the router does not support "looping" that traffic back to the server internally, the installation script will time out and report an unknown error.
To confirm if this is the issue, run the following command from the server's own terminal (replace x.x.x.x with your server's Public IP):
telnet x.x.x.x 50000If the connection is refused or hangs, Hairpin NAT is likely disabled or Port 50000 is blocked by an external firewall.