Pterodactyl ApplicationInstall

Summary

Update the build configuration of a specified server on the Pterodactyl panel, modifying resource limits, allocations, and related build settings.

Inputs

• Server (required) — Select the server to update by its ID.
• Primary Allocation — Optionally specify the primary allocation for the server to change; leave empty to keep the current allocation.
• Memory Limit (MB) — Set the memory limit in megabytes; leave empty or 0 to retain the current limit.
• Swap Limit (MB) — Set the swap memory limit in megabytes; leave empty or 0 to retain current value.
• Disk Limit (MB) — Set the disk space limit in megabytes; leave empty or 0 to keep current value.
• CPU Limit (%) — Define the CPU limit as a percentage (100% equals 1 core); leave empty or 0 to keep current.
• IO Weight — Assign block IO weight between 10 and 1000; leaving empty or 0 keeps the existing setting.
• CPU Threads — Specify CPU thread pinning as a string (e.g., "0-3" or "0,2,4"); leave empty to maintain current.
• Database Limit — Set maximum allowable databases; leave empty or -1 to keep the current limit.
• Allocation Limit — Set maximum allocations allowed; leaving empty or -1 retains current limit.
• Backup Limit — Set maximum allowed backups; leave empty or -1 to keep existing value.
• Disable OOM Killer — Boolean to disable or enable the out-of-memory killer feature.
• Add Allocations — Select additional available allocations from the server's node to add.
• Remove Allocations — Select current allocations assigned to this server to remove.

Output shape

a single JSON object containing the updated server build details as returned by the Pterodactyl API

Only the specified fields are updated; unspecified limits or settings retain their existing values. The operation modifies server resource allocations and build parameters without altering server identity or startup configuration.

Examples

Example 1: Update a server's memory and CPU limits and add a new allocation

Server ID selected; Memory Limit set to 2048 MB; CPU Limit set to 50%; one available allocation selected to add; other fields left default to retain existing values.

Example 2: Change the primary allocation and remove an old allocation while keeping other limits unchanged

Server ID selected; Primary Allocation changed; Remove Allocations includes one or more existing allocations; resource limits left empty or 0 to keep.