Git & Deployment
The full HTTPS URL of your Git repository — for example,
https://github.com/user/my-app. The egg clones this repository into the container on first start.Leave this empty if you prefer to upload your project files manually using the panel’s File Manager. When left empty, the egg skips cloning entirely and expects a package.json to already be present in the container.The branch to clone and run. Set this to any valid branch name, such as
main, master, or production.Leave it empty to use the repository’s default branch as configured on the remote.Controls whether the egg pulls the latest commits from your repository every time the server starts.
1— runsgit reset --hardfollowed bygit pullon each startup, ensuring your container always runs the newest code.0— skips the pull. Use this when you want to pin the server to a specific commit or manage deployments manually.
Even with
AUTO_UPDATE set to 1, dependencies are reinstalled and (in production mode) the app is rebuilt on every start. Keep this in mind for servers where startup time matters.Private Repository Authentication
Your GitHub or GitLab username. Only required when connecting to a private repository.Leave empty for public repositories — the egg will clone without authentication.
A personal access token with at least the
repo scope. Only required for private repositories.Generate one at GitHub Settings → Tokens. Set GIT_URL to the plain HTTPS URL without any credentials embedded — the egg injects your username and token automatically.Runtime
Determines how Next.js starts. Accepted values are
production and development.production— runsnext buildto produce an optimized build, then starts the server withnext start. Use this for live, publicly facing sites.development— skips the build step and starts withnext dev, enabling hot-reload. Use this when actively developing your application.
In
development mode, the build step is skipped entirely. Your changes are reflected immediately without restarting the server.The package manager used to install your Node.js dependencies. Accepted values are
auto, npm, pnpm, and yarn.auto— the egg inspects your repository for a lockfile and selects the appropriate manager:pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, otherwise npm.npm,pnpm, oryarn— forces a specific manager regardless of which lockfiles are present.
Cloudflare Tunnel
A Cloudflare Tunnel token from your Zero Trust dashboard under Networks → Tunnels → Configure → Run token.When set, the egg installs
cloudflared and starts the tunnel in the background before launching Next.js. Leave empty to disable tunnel support entirely.Variable Reference
| Name | Env Key | Default | Required |
|---|---|---|---|
| Git Repository URL | GIT_URL | (empty) | No |
| Git Branch | GIT_BRANCH | main | No |
| Auto Update | AUTO_UPDATE | 1 | Yes |
| Git Username | USERNAME | (empty) | No |
| Git Access Token | ACCESS_TOKEN | (empty) | No |
| Run Environment | NODE_RUN_ENV | production | Yes |
| Package Manager | PACKAGE_MANAGER | auto | Yes |
| Cloudflare Tunnel Token | CLOUDFLARE_TOKEN | (empty) | No |