OceanLaunch docs

Build, ship and run your apps

Start here

Java apps

Upload a JAR or WAR, or let OceanLaunch build your Git repository. Choose Java 17, 21 or 25.

Create the app

In your workspace choose New app. The name (2 to 60 characters) also becomes the app's address, for example billing-api-acme.oceanlaunch.app, and can't be changed later.

Executable JAR

Upload a .jar up to 150 MB that runs with java -jar: its manifest must have a Main-Class. A Spring Boot JAR from mvn package or gradle bootJar is exactly that. To deploy a new version, upload it on the app's page.

WAR on Tomcat

Upload a .war (it must contain WEB-INF/). It runs as the root app of Tomcat, so it's served at /. Choose the servlet API your app uses:

Tomcat always listens on port 8080.

Git repository

Give the HTTPS address of a repository on GitHub, GitLab, Bitbucket or Codeberg, and a branch (default main). Choose the build tool:

Build toolRunsTakes the JAR from
Mavenmvn -B -q -DskipTests packagetarget/
Gradle./gradlew --no-daemon -q build -x test (or gradle without a wrapper)build/libs/

The build skips tests and uses the first JAR in that folder, ignoring -plain, -sources and -javadoc JARs. The project must be at the root of the repository. A build may take up to 30 minutes. For private repositories and deploying on every push, see Git and deploy on push.

How it runs

More on ports, health checks and logs: Logs, restarts and health.