Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/calagopus/panel/llms.txt

Use this file to discover all available pages before exploring further.

Nodes are the Wings daemons that actually run your game servers. Locations are logical labels used to group nodes — for example, by data center region. Every node belongs to exactly one location, and every server runs on exactly one node.

Locations

Locations provide a way to organize nodes by geography or purpose. When you create a server through the admin panel, you can filter the node list by location to place the server in the right region.
1

Open Locations

In the admin panel, navigate to Locations.
2

Create a location

Click Create and enter a short name such as us-east or eu-west. Add an optional description for clarity.
3

Save

Click Save. The location is now available when creating or editing nodes.
You can view the nodes assigned to a location from the location’s detail page under the Nodes tab.

Nodes

A node represents a single Wings daemon installation. Calagopus communicates with Wings over the node’s configured URL to start, stop, and transfer servers.

Adding a node

1

Open Nodes

In the admin panel, navigate to Nodes and click Create.
2

Fill in basic details

Enter a name for the node and select the location it belongs to.
3

Set the URL

Enter the internal URL Calagopus uses to reach Wings (for example, https://node1.example.com:8080). This URL is used for API communication and is not exposed to end users.
4

Set the public URL (optional)

If Wings is behind a reverse proxy or uses a different address for WebSocket connections and file downloads, enter that address in Public URL. Leave this blank to use the same URL as the internal URL.
5

Configure SFTP

Enter the SFTP host and port. The default SFTP port is 2022.
6

Set resource limits

Enter the total Memory and Disk available on the node. These values are used to calculate how much capacity remains when assigning resource limits to new servers.
7

Save

Click Save. The node is created and you are taken to its detail page.

Node configuration

After creating a node, navigate to its Configuration tab to get the Wings configuration. This tab shows a generated YAML snippet that you paste into /etc/pterodactyl/config.yml on the Wings host, or you can copy the one-liner command that does this automatically. The page also exposes a Live Configuration editor that connects directly to the running Wings daemon and lets you view and save its current config.yml without leaving the browser.
Saving an invalid configuration file from the Live Configuration editor can prevent Wings from starting. Always verify YAML syntax before saving.

Resetting the auth token

If a node’s authentication token is compromised or you need to re-pair it, go to the node’s General tab and click Reset Token. Calagopus generates a new token and displays the updated configuration. You must update Wings with the new token before it can reconnect.

Deployment and maintenance modes

Two toggles on the node’s General tab control availability:
ToggleEffect
Deployment EnabledWhen off, new servers cannot be assigned to this node. Existing servers are unaffected.
Maintenance EnabledFlags the node as under maintenance. Useful for scheduled downtime.

Wings proxy

When Public URL is left blank on a node, Calagopus can optionally route WebSocket connections and file downloads through the panel itself using the Wings Proxy feature. To enable this, click the globe icon next to the Public URL field on the node’s General tab. This fills in a proxy URL of the form https://your-panel/wings-proxy/<node-uuid>.
The Wings Proxy is useful when Wings nodes are on a private network that end users cannot reach directly. All traffic is forwarded through the panel, which does add latency.

Allocations

An allocation is a single IP:port combination that can be assigned to a server as its network binding. Allocations are managed per node.
1

Open the Allocations tab

Navigate to Nodes, open the node, and click the Allocations tab.
2

Create allocations

Click Create and enter an IP address along with one or more ports or port ranges (for example, 25565 or 25565-25575). Each combination becomes a separate allocation entry.
3

Assign to servers

Allocations are available immediately and can be assigned to servers from the server’s Network tab or during server creation.
You can select multiple allocations using click and Shift+click, or Ctrl+A to select all, and then delete them in bulk using the action bar that appears.

Node statistics and logs

The Statistics tab shows live node resource usage — CPU, memory, and disk — pulled directly from the Wings daemon. The Logs tab streams Wings log output so you can diagnose daemon-level issues without SSH access.

Build docs developers (and LLMs) love