Skip to main content
Deploy your Next.js application directly from a Git repository on a Pterodactyl or Pelican panel server. The egg handles cloning, dependency installation, building, and starting your app automatically — just set a few variables and go.

Installation

Import the egg into your Pterodactyl or Pelican panel and create your first server.

Quick Start

Get your Next.js app running in minutes with step-by-step instructions.

Configuration

Explore all variables you can set to control how your app is cloned, built, and run.

Troubleshooting

Fix common issues with startup, builds, private repos, and dependencies.

​
What the egg does

1

Clone your repository

On first start, the egg clones your Git repository into the container. Point it at any public or private GitHub or GitLab repo.
2

Install dependencies

Dependencies are installed automatically using your preferred package manager — npm, pnpm, or yarn. The package manager is detected from your lockfile or you can set it explicitly.
3

Build and start

In production mode, next build runs before next start. In development mode, next dev starts immediately with hot-reload enabled.
4

Stay up to date

With auto-update enabled, the egg pulls the latest commits from your branch every time the server restarts — no manual intervention needed.

​
Key features

  • Production & development modes — run an optimized production build or a hot-reload dev server
  • Auto-update — pull the latest commits on every startup
  • Private repositories — authenticate with a personal access token
  • .env injection — upload a .env.pterodactyl file via the File Manager; it becomes .env on startup
  • Package manager support — npm, pnpm, and yarn, with automatic detection
  • Cloudflare Tunnel — expose your app publicly without opening ports
  • Multi-version Node.js — choose from Node.js 18 through 25