Start here
Node.js, Python and PHP apps
Connect a Git repository and OceanLaunch installs its dependencies, builds it and starts it. Choose Node.js 22 or 24, Python 3.12, 3.13 or 3.14, or PHP 8.3 or 8.4.
Create the app
In your workspace choose New app, then Node.js from Git, Python from Git or PHP from Git. Give the HTTPS
address of a repository on GitHub, GitLab, Bitbucket or Codeberg and a branch (default main). Private
repositories work the same way as for Java: see Git and deploy on push. The project must be
at the root of the repository.
The build and start commands are optional. Leave them empty to use the defaults below, and change them any time on
the app's Settings tab. Each is one line; join several commands with &&. They apply on
the next deploy.
Node.js
Your repository needs a package.json. The lockfile decides how dependencies are installed:
| Lockfile | Installs with |
|---|---|
pnpm-lock.yaml | pnpm install --frozen-lockfile |
yarn.lock | yarn install --frozen-lockfile (Yarn 1) or --immutable (Yarn 2+) |
package-lock.json | npm ci |
| none | npm install |
pnpm and Yarn come from corepack, so the packageManager field in package.json picks their
version. Then:
- Build: your build command, or else the
buildscript, ifpackage.jsonhas one. - Start: your start command, or else the
startscript, or elsenodewith themainfile,server.jsorindex.js.
Your app must listen on the port in PORT (8080 unless you change it in Settings), on every interface.
HOST and HOSTNAME are set to 0.0.0.0, which Next.js, Nuxt and most servers
pick up. NODE_ENV is production.
// Express
app.listen(process.env.PORT || 3000);
Python
Dependencies go into a virtualenv, from the first of these that your repository has:
| File | Installs with |
|---|---|
requirements.txt | pip install -r requirements.txt |
uv.lock | uv sync --frozen --no-dev |
pyproject.toml | pip install . (Poetry, Hatch, setuptools and others) |
A Pipfile isn't supported yet: export it with pipenv requirements > requirements.txt. Then:
- Build: your build command, if you set one, for example
python manage.py collectstatic --noinput. - Start: your start command, or else the
web:line of aProcfile. Python has no default, so set one of the two.
| Framework | Start command |
|---|---|
| FastAPI | uvicorn main:app |
| Flask | gunicorn app:app |
| Django | gunicorn mysite.wsgi |
gunicorn, uvicorn and flask run listen on the app's port, on every interface, without any flags. For
any other server, use $PORT and 0.0.0.0, like
hypercorn main:app --bind 0.0.0.0:$PORT.
PHP
For Laravel, Symfony or plain PHP. The app is served by Apache with PHP, and the extensions most apps need are there: MySQL and MariaDB, PostgreSQL, Redis, GD, intl, zip, bcmath, exif, pcntl and OPcache.
- Dependencies: a
composer.jsonat the repository root is installed withcomposer install --no-dev --optimize-autoloader. - Front-end: if
package.jsonhas abuildscript (like Laravel's Vite), it runs first, with npm, pnpm or yarn from your lockfile. - Web root: the folder with your
index.php. Leave it empty andpublicis used when it has one (Laravel, Symfony), otherwise the repository root..htaccessfiles work, withmod_rewrite; files starting with a dot are never served. - Build command (optional): runs after Composer, like
php artisan storage:link. - Start command (optional): runs each time the app starts, before the web server, like
php artisan migrate --force && php artisan optimize. If it fails, the new version doesn't start and the current one keeps running. You don't start Apache yourself.
Laravel behind OceanLaunch: trust the proxy ($middleware->trustProxies(at: '*') in
bootstrap/app.php) so links use https, set APP_KEY and
LOG_CHANNEL=stderr as variables, and read the database from DATABASE_URL. The
Laravel template does all of this. PHP errors and Apache's access log go to the app's
logs. Uploads can be up to 64 MB, and a request can run for 60 seconds.
The first build of a PHP app takes a few minutes, while the extensions are compiled; later builds reuse them.
How it runs
- The build runs on the official
node,pythonorphpimage, which has the compilers some packages need. The app runs on the matching slim image, so it stays small. - Your app runs as an unprivileged user (UID 10001) that owns its folder, with no Linux capabilities, on your workspace's private network. It gets 512 MB of memory and half a CPU on Free.
- Your variables and secrets are there when the app runs, but not during the build. Values a frontend build
needs (like Next.js
NEXT_PUBLIC_ones) have to be in the repository for now. - A new version only gets traffic once it answers on its port, or on its health check path if you set one in Settings. If it never does, the current version keeps running. The build log shows the start command it used.