ConvoyDocs

Deleting Applications

Remove deployed applications and free resources.

Deleting an application stops all running containers and removes all associated resources.

How to delete an app

  1. Go to Apps and click on the app you want to delete.
  2. Click the Delete button at the bottom of the page.
  3. Confirm in the dialog.

What gets removed

When you delete an application, Convoy Cloud removes:

  • The running deployment and all pod replicas
  • The Service and Ingress routing rules
  • The persistent volume — the /data directory and all data stored in it are permanently deleted
  • Any custom domain assignment (the domain is unassigned, not deleted)

Persistent volume note: each app has a 4 GiB persistent volume mounted at /data. This volume is deleted when the app is deleted. If you store critical data there, back it up before deleting the app.

What is retained

  • Build cache — the container image is kept in the registry. If you redeploy the same commit later, the build phase is skipped.
  • Custom domain records — the domain itself is not deleted; it becomes unassigned and can be reused.
  • Billing records — usage up to the deletion point is recorded on your current invoice.
  • Audit events — the full deployment and activity history for the app remains in the Audit log.

Billing impact

Billing stops at the moment of deletion. Your next invoice reflects usage only up to the deletion time.

App count

After deletion, the app slot is freed. If you were at your plan's app limit (3 on Free, 10 on Business), you can create a new app immediately.