Skip to content
uploy docs

Apps

What it is

Section titled “What it is”

An app is a long-running HTTP service built from a GitHub repository. Each app belongs to exactly one project. Apps are built with Nixpacks and run as Kubernetes Deployments behind a Traefik IngressRoute.

How to use

Section titled “How to use”
  • Create: project detail page → New app → connect GitHub → choose repo and branch.
  • Redeploy: push to the configured branch, or from the UI use Actions → Redeploy.
  • Restart / Stop / Start: Actions menu on the app detail page.
  • Roll back: not yet shipped — push a new commit (or git revert) to revert. One-click rollback is on the Phase 5 hardening roadmap.
  • Delete: not yet shipped from the UI. The DELETE /api/apps/{id} endpoint exists but no UI calls it (and the backend currently leaves k8s resources orphaned — see docs/known-technical-debt.md). Use kubectl delete on the deployment in the meantime if you must remove an app.

Default URL

Section titled “Default URL”

<slug>.run.uploy.eu, where <slug> is the app slug chosen at creation time.

Limits & defaults

Section titled “Limits & defaults”
  • One GitHub repository per app.
  • One branch per app (configurable in settings).
  • Every app gets your plan’s CPU and memory (see Plans and caps).
  • Build timeout: 15 minutes per deployment.
Section titled “Related”