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:
- jakarta.servlet (the default) runs on Tomcat 10.1: Spring 6, Spring Boot 3 and later, Jakarta EE 9+.
- javax.servlet runs on Tomcat 9: older apps such as Spring 5 or Java EE 8.
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 tool | Runs | Takes the JAR from |
|---|---|---|
| Maven | mvn -B -q -DskipTests package | target/ |
| 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
- Your app gets 512 MB of memory and half a CPU (on Free). Java uses up to 75% of the memory for its heap and stops if it runs out, so the platform can start it again.
- It runs as an ordinary user with no special permissions, and can't reach other workspaces' apps.
- It must answer HTTP on its port (8080 by default). OceanLaunch sets
PORTandSERVER_PORTto that port, so Spring Boot uses it by itself. - New versions replace the old one with no downtime: the old version keeps serving until the new one answers.
More on ports, health checks and logs: Logs, restarts and health.