Skip to main content

Applications

Applications are Git-backed workloads that Moltern builds, deploys, routes, and monitors.

Moltern applications first app screen

Use applications for code you own:

  • Web services.
  • APIs.
  • Frontend sites.
  • Server-rendered apps.
  • Static sites.
  • Dockerfile-based services.
  • Workers with an HTTP endpoint.

Application Types

TypeUse It When
Web serviceYour app runs a process and listens on a port. Examples: Node, Go, Python, Ruby, Java, Rust, PHP, and API servers.
Static siteYour repository builds static assets that can be served without a running app server.
Dockerfile appYour repository includes a Dockerfile and you want Moltern to build from it.

What Moltern Tracks

Moltern application creation entry point

Each application has:

  • Name and slug.
  • Environment.
  • Repository and branch.
  • Build pack or Dockerfile setting.
  • Build commands and start command overrides.
  • Runtime port and health check path.
  • Generated Moltern URL.
  • Custom domains.
  • Environment variables.
  • Private service connections for backend workloads.
  • Deployment records.
  • Logs.
  • Active deployment pointer for static sites.
  • Replica, CPU, and RAM sizing when supported.
  • Optional shared filespace for web service apps.

Application Lifecycle

  1. Create the application from a repository.
  2. Add variables and build-time settings.
  3. Deploy the first version.
  4. Watch logs until the deployment succeeds.
  5. Open the generated Moltern URL.
  6. Add a custom domain if needed.
  7. Resize only after checking the billing impact.
  8. Roll forward with new deployments or roll back when a static-site release should be restored.

Source Access

Moltern can use connected GitHub repositories or a manually entered repository URL.

For private GitHub repositories, install the Moltern GitHub App from the application creation flow. The GitHub popup lets you select the repositories Moltern can deploy. It does not change your Moltern login identity.

For public or manually entered repositories, paste the repository URL and choose the branch.

Good Application Defaults

  • Keep production and staging apps in separate environments.
  • Set the correct port before deploying if auto-detection cannot infer it.
  • Keep secrets in Moltern variables, not in repository files.
  • Use build variables only when a value is needed during the build.
  • Connect private services from the app settings instead of exposing databases publicly.
  • Add a health check path that returns quickly.
  • Deploy once before adding a custom domain.
  • Review logs before retrying a failed deployment.