K

Manage app state

Take an unused app down to zero cost, bring it back, and archive it. Archived apps are permanently deleted after 30 days.

An app doesn't have to keep running just because you built it.
Take it down when you're not using it for a while, and archive it when you're done with it.

Taking an app down sets its state to Suspended; archiving sets it to Archived — that's what shows in the app list and console. What each of the four deploy statuses means is in Manage deployments.

Taking it down and bringing it back

Take down at the top of the app console clears the server the app was running on. It costs nothing while it's down.

  • Code, database, files, and environment variables all stay
  • The address no longer serves the app
  • Bringing it back redeploys the last successful deploy as is — no new deploy needed

Only an app that has deployed successfully and is running can be taken down.

If it's suspended and you didn't do it, it's one of these. The console shows the reason.

  • It exceeded your plan's resource limit
  • It kept crashing, so it was taken down automatically
  • Pay-as-you-go credits ran out

Archiving

Archive an app you're done with. Open it from the app list and click Archive. It disappears from the list and the store, and stays visible under the Archived tab.

30 days after archiving, the app and its data are permanently deleted.

  • You get an email and an inbox notification 7 days before the deletion
  • Un-archiving before then cancels the scheduled deletion
  • Once permanently deleted, the database, files, and environment variables are all reclaimed — there's no undo

If you're only pausing for a while, take it down instead. A suspended app costs nothing and is never deleted.

Which one do I want

SituationDo this
I'll use it again in a few weeksTake it down — zero cost, data kept, restore any time
I'm done with it but want the recordArchive — but download anything you need first; it's deleted in 30 days
I want it gone entirelyArchive and leave it — it cleans itself up after 30 days

You've succeeded when

A taken-down app shows as Suspended in the list, and an archived one appears under the Archived tab. An app you brought back serves its old screen at its address again.

Next, read deploy status and logs in Manage deployments.