Pterodactyl Application icon

Pterodactyl Application

Administrative panel management with Pterodactyl Panel Application API

Node → Create

AI-generated

Summary

Create a new infrastructure node in the Pterodactyl panel with specified configuration parameters such as name, location, domain, resources, and daemon settings.

Inputs

  • Name (required) — Set the unique name for the node.
  • Location (required) — Select the location (ID) where the node will reside, loaded dynamically from existing locations.
  • FQDN (required) — Provide the fully qualified domain name for the node, e.g. node.example.com.
  • Behind Proxy — Specify whether the node's Wings daemon is behind a proxy that terminates SSL connections.
  • Scheme (required) — Choose the connection scheme (HTTP or HTTPS) used for the node.
  • Memory (required) — Declare the total memory available on the node in megabytes.
  • Memory Overallocate — Set the percentage of memory over-allocation allowed (use -1 to disable check). Defaults to 0.
  • Disk (required) — Specify the total disk space available on the node in megabytes.
  • Disk Overallocate — Set the percentage of disk over-allocation allowed (use -1 to disable check). Defaults to 0.
  • Upload Size — Maximum allowed upload size in megabytes for the Wings daemon.
  • Daemon Base Directory — Provide the base directory path where Wings daemon stores server data, defaulting to /var/lib/pterodactyl/volumes.
  • Daemon SFTP Port — The port number used for SFTP connections to the Wings daemon, defaulting to 2022.
  • Daemon Listen Port — The port number on which the Wings daemon listens for HTTP connections, defaulting to 8080.
  • Maintenance Mode — Enable or disable maintenance mode to prevent new servers from being created on the node.
  • Public — Indicate whether the node is publicly accessible for automatic server allocation.

Output shape

a single JSON object representing the created node

The operation returns the JSON response from the Pterodactyl API representing the newly created node, including its attributes and identifiers. Errors will throw exceptions unless 'Continue On Fail' is enabled, in which case errors are returned per item.

Discussion