Skip to content

How app deployment works on OrbixPanel

OrbixPanel deploys apps straight from a Git repository (or a zip/URL). It looks at your code, picks a runtime, builds it, and serves it. Understand the handful of rules below and every framework guide in this section becomes obvious.

Three kinds of app

Exactly one applies to your project:

KindExamplesHow it’s served
StaticVite, React (CRA), Angular, Astro, Hugo, plain HTMLnginx serves the built files directly
Server appNext.js, Express, Nest, Django, Flask, FastAPI, Goruns as a managed service behind an nginx reverse proxy
PHPLaravel, WordPress, plain PHPnginx + php-fpm

Runtime is auto-detected (Node via package.json, Python via requirements.txt, Go via go.mod, PHP via composer.json/index.php). A Node project that has a build script but no start script is treated as a static site — exactly what you want for Vite/React.

The one rule for server apps: listen on $PORT

This is the thing everyone needs to know. OrbixPanel starts your app with a PORT environment variable and expects it to listen on that port, on 0.0.0.0. The reverse proxy forwards your domain’s traffic there, and a health check confirms the app is listening — if it isn’t, the deploy fails.

  • Node: app.listen(process.env.PORT)
  • Python/Go: bind 0.0.0.0:$PORT (the framework guides show the exact command OrbixPanel runs)

Hard-coding port 3000 or 8080 is the #1 reason a deploy “builds fine but won’t go live.” Read the port from the environment.

What gets built

RuntimeInstall & buildStart
Nodenpm ci (or install), then npm run build if presentnpm start, or your entry file
Pythoncreates a .venv, installs requirements.txtgunicorn/uvicorn (auto-added if missing)
Gogo build -o app ../app
Staticnpm run build if presentnginx serves the output folder
PHPcomposer install --no-devphp-fpm serves public/ (or the repo root)

After it’s live

Now pick your framework from the sidebar.


Running OrbixPanel? Point it at a repo and it deploys itself. OrbixPanel.com → — the free, self-hosted, AI-powered hosting control panel.