An orphaned resource is one that physically exists on your server but does not appear inside your RunCloud dashboard. Because RunCloud can’t see these resources in the regular dashboard view, you can’t manage them through the standard interface.

If a database, database user, or web application is visible inside your RunCloud dashboard, it is not an orphaned resource. RunCloud can still manage, edit, or delete any resource that appears on the panel.

Orphaned resources consume disk space and memory without your knowledge.

Why Do Resources Become Orphaned?

Resources usually become orphaned for two main reasons:

  • Interrupted Deletion Processes: If you delete a database or web application, but your server experiences a connection drop or an agent interruption midway through the process, the resource may disappear from the RunCloud panel while remaining intact on your server.
  • Manual Server Changes: If you log in to your server directly via the terminal and manually create a database, database user, or directory, RunCloud does not automatically track it in the panel.

How to Scan and Clean Up Orphaned Resources

You can run a scan at any time to let the RunCloud agent inspect your server and clean up stray files.

Follow these steps to clean up orphaned resources:

  1. Log in to your RunCloud dashboard and click on the name of the server that you want to manage.
  2. Navigate to the Tools menu in the left sidebar and look for the “Orphan Cleaner”, or the “Orphan Resources” section on the page.
  3. Click on the Scan button to begin checking your server for untracked resources.
Orphan scan
  1. Review the list of detected web applications, databases, and database users. Check the box next to each resource that you no longer need.
  2. Click the Delete button to permanently remove the selected resources from your server.