[{"data":1,"prerenderedAt":30},["ShallowReactive",2],{"doc-en-add-egg-pterodactyl-panel":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":20,"docGroup":27,"docGroupIcon":27,"link_fr":28,"bodyHtml":29},"\u002Fdocs\u002Fen\u002Fvps\u002Fvps-pterodactyl\u002Fadd-egg-pterodactyl-panel","add-egg-pterodactyl-panel","How to Add an Egg to the Pterodactyl Panel","Learn how to import and add an Egg to your Pterodactyl panel in order to deploy new game servers easily.","vps","vps-pterodactyl","tabler:file-text","2026-07-24","Winheberg",36,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fvps-pterodactyl\u002Fadd-egg-pterodactyl-panel.webp",[16,17,18,19],"egg","panel","server","guide",[21,22,23,24,25,26],"pterodactyl egg","import egg","pterodactyl panel","nests","game server","admin panel","","\u002Fdocs\u002Fvps-pterodactyl\u002Fajouter-egg-panel-pterodactyl","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Eggs\u003C\u002Fstrong> allow you to add new games or specific applications to your Pterodactyl panel.\u003C\u002Fp>\n\u003Cp>Each Egg contains all the configuration files and parameters required to automatically deploy an instance with the correct startup settings, variables, and automated installation scripts.\u003C\u002Fp>\n\u003Ch2>1. Find the Required Eggs\u003C\u002Fh2>\n\u003Cp>Go to the official repository for Pterodactyl Eggs:\u003C\u002Fp>\n\u003Cp>👉 \u003Cstrong>\u003Ca href=\"https:\u002F\u002Feggs.pterodactyl.io\u002F\">eggs.pterodactyl.io\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>This directory contains a massive collection of community-maintained Eggs for:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Games (game servers, proxies)\u003C\u002Fli>\n\u003Cli>Applications (databases, bots, administrative tools)\u003C\u002Fli>\n\u003Cli>Programming Languages (runtime environments)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>You can easily look for an Egg matching your specific needs using the website's search bar. Downloaded elements come as a single configuration file format: \u003Cpre>\u003Ccode>.json\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fp>\n\u003Ch2>2. Access the Admin Panel\u003C\u002Fh2>\n\u003Cp>Log in to the global management interface of your infrastructure. Open your administrative dashboard by clicking on the gear icon located at the top right corner of the screen.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fvps-pterodactyl\u002Fadd-egg-pterodactyl-panel-1779996815881-e1043da669d4659b599ce3ce.webp\" alt=\"Pterodactyl Admin Panel\" width=\"300\" \u002F>\n\n\u003Ch2>3. Open Service Management\u003C\u002Fh2>\n\u003Cp>Inside the left sidebar of the administration control area, locate the service management section:\u003C\u002Fp>\n\u003Col>\n\u003Cli>Scroll down to the \u003Cpre>\u003Ccode>Nests\u003C\u002Fcode>\u003C\u002Fpre> option and click it.\u003C\u002Fli>\n\u003Cli>At the top right of the Nest management panel, click the \u003Cpre>\u003Ccode>Import Egg\u003C\u002Fcode>\u003C\u002Fpre> button.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fvps-pterodactyl\u002Fadd-egg-pterodactyl-panel-1779996857013-2128f24dbd5c4bc03a087e42.webp\" alt=\"Pterodactyl Nest Management\" width=\"800\" \u002F>\n\n\u003Ch2>4. Import an Egg\u003C\u002Fh2>\n\u003Cp>Inside the importation overlay menu:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Click the file selector and upload the downloaded \u003Cpre>\u003Ccode>.json\u003C\u002Fcode>\u003C\u002Fpre> Egg configuration file.\u003C\u002Fli>\n\u003Cli>In the \u003Cpre>\u003Ccode>Associated Nest\u003C\u002Fcode>\u003C\u002Fpre> drop-down field, pick the corresponding parent category (e.g., Minecraft, Source Engine, Voice Servers, etc.).\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The associated Nest is purely meant to classify and structure your different Eggs so you can find them easily when creating a new instance.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fvps-pterodactyl\u002Fadd-egg-pterodactyl-panel-1779996883943-b52ed9a27a9db1e82a567610.webp\" alt=\"Importing a Pterodactyl Egg\" width=\"600\" \u002F>\n\n\u003Ch2>5. Finalize the Import\u003C\u002Fh2>\n\u003Cp>Click the blue \u003Cpre>\u003Ccode>Import\u003C\u002Fcode>\u003C\u002Fpre> button located at the bottom right to submit the configuration.\u003C\u002Fp>\n\u003Cp>The panel will process and register the configuration data. Your brand new Egg is now fully available to build or edit game servers.\u003C\u002Fp>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ "Validation Failed" error during import\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Corrupted or Outdated JSON File\u003C\u002Fstrong>: This issue usually happens if the \u003Cpre>\u003Ccode>.json\u003C\u002Fcode>\u003C\u002Fpre> file structure is broken, incomplete, or coded for an obsolete Pterodactyl version. Re-download the file from the official source repository.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unique Identifier Conflict\u003C\u002Fstrong>: If the dashboard states that the Egg already exists, the UUID hardcoded within the file is already assigned to another active Egg on your setup.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Server remains stuck on the "Installing" phase\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Broken Installation Script\u003C\u002Fstrong>: The build script bundled inside the Egg might point to remote asset links that are no longer online. Check the \u003Cpre>\u003Ccode>Install Script\u003C\u002Fcode>\u003C\u002Fpre> tab of the Egg settings to check the external setup URLs.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Server crashes instantly right after creation\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Missing Core Startup Variables\u003C\u002Fstrong>: A few custom community-made Eggs strictly require custom API keys or specific software versions defined within the server variables tab. Ensure all required fields are accurately filled during server creation.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Administrative Best Practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Docker Image Integrity\u003C\u002Fstrong>: Always review the \u003Cpre>\u003Ccode>Docker Images\u003C\u002Fcode>\u003C\u002Fpre> path inside the Egg configuration. Only run Docker images pulling from official repositories or trusted verified creators to prevent any security vulnerabilities on your nodes.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Update Schedules\u003C\u002Fstrong>: Game requirements change frequently. Remember to periodically check the official repository to see if a newer iteration of your Egg is available to update installation routines and startup variables.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Nest Organization\u003C\u002Fstrong>: Keep your panel structured. Take the time to build dedicated, distinct Nests if you are importing custom developer builds or unique tools to maintain a clean indexing hierarchy.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>Importing and customizing advanced custom Eggs requires a solid understanding of Docker structures and environment variables.\u003C\u002Fp>\n\u003Cp>If your Egg setup fails or causes runtime issues on your instances, our technical engineering team is ready to guide you. Open a technical support ticket from your billing area over at \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">billing.winheberg.com\u003C\u002Fa>\u003C\u002Fstrong> to get custom assistance.\u003C\u002Fp>\n\u003Cp>Your new Egg is now fully operational and ready for your deployments! 🎮\u003C\u002Fp>\n",1788993144640]