Admin

Adding Servers

Connect additional servers to your Opterius Panel on Business or Datacenter plans.

Last updated 1775606400

Multi-server support is available on the Business plan (up to 5 servers) and Datacenter plan (unlimited servers). Each additional server runs its own Opterius Agent and is managed centrally from your Panel.

Prerequisites

  • An active Business or Datacenter license. See Activating Your License.
  • A fresh server running a supported OS (AlmaLinux 8/9, Rocky Linux 8/9, Ubuntu 22.04/24.04).
  • Root SSH access to the new server.
  • The new server must be able to reach your Panel on port 8443, and your Panel must be able to reach the new server on port 7443.

Step 1: Provision the New Server

Start from a clean OS installation. The agent installer handles all dependencies. Do not pre-install nginx, MariaDB, or any other stack components — the installer will configure everything the agent needs.

Step 2: Generate an Agent Token

In your Panel, go to Server Mode → Servers → Add Server.

Fill in:

  • Hostname or IP — the public IP or resolvable hostname of the new server.
  • Display Name — a label for your own reference (e.g., us-east-2 or client-vps-01).
  • SSH Port — for display only; the Panel communicates via the agent API, not SSH.

Click Generate Token. The Panel produces a one-time agent installation token. Copy it — it is shown once.

Step 3: Run the Agent Installer on the New Server

SSH into the new server as root and run:

curl -sL https://get.opterius.com/agent | bash -s -- --token=TOKEN

Replace TOKEN with the value copied from the Panel. The installer:

  1. Downloads and installs the agent binary to /usr/local/bin/opterius-agent.
  2. Registers the agent with your Panel using the token.
  3. Creates and starts the opterius-agent systemd service.
  4. Configures the agent to listen on 127.0.0.1:7443.

Installation typically completes in under two minutes.

Step 4: Confirm the Server is Online

Return to Server Mode → Servers. The new server should appear with a status of Online within 30 seconds of the agent registering. If it remains Pending after a minute, check:

  • The token was not already used or expired.
  • Port 7443 is not blocked by a firewall on the new server.
  • The Panel IP is permitted in any firewall rules on the new server.
# On the new server — verify the agent is running
systemctl status opterius-agent

# Check the agent is listening
ss -tlnp | grep 7443

Note: The agent only binds to 127.0.0.1:7443. The Panel connects to it via an outbound API call from the Panel's perspective, routed through a secure tunnel — not directly to port 7443 from the internet. Ensure the Panel server's outbound connections to the agent server are not blocked.

Creating Accounts on Additional Servers

Once a server is Online, you can target it when creating hosting accounts. In Server Mode → Accounts → New Account, a Server dropdown appears when more than one server is connected. Select the target server before submitting.

Existing accounts cannot be migrated between servers from the Panel UI. Use Account Migration for that workflow.

Typical Use Cases

  • Client isolation — dedicate a server to a single large client or group of clients.
  • Geographic distribution — place servers in regions close to your clients' users.
  • Load distribution — spread new account creation across servers to avoid overloading any single machine.
  • Staging environments — run a separate server for dev/test accounts.

Related

Next
The Admin Dashboard →