OceanLaunch docs

Build, ship and run your apps

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:

LockfileInstalls with
pnpm-lock.yamlpnpm install --frozen-lockfile
yarn.lockyarn install --frozen-lockfile (Yarn 1) or --immutable (Yarn 2+)
package-lock.jsonnpm ci
nonenpm install

pnpm and Yarn come from corepack, so the packageManager field in package.json picks their version. Then:

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:

FileInstalls with
requirements.txtpip install -r requirements.txt
uv.lockuv sync --frozen --no-dev
pyproject.tomlpip install . (Poetry, Hatch, setuptools and others)

A Pipfile isn't supported yet: export it with pipenv requirements > requirements.txt. Then:

FrameworkStart command
FastAPIuvicorn main:app
Flaskgunicorn app:app
Djangogunicorn 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.

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