# Managing Apps

## App Status

App Status is determined by the status of the Instances within the App or by the DELETE action. All Instances in an App must be in ‘Running’ status for the App status to equal ‘Running’.

Table 1. App Statuses

     | Status Icon | App Status | Status Reason |
| --- | --- | --- |
| ../../_images/running_icon.svg | Running | All Instance Statuses = Running |
| ../../_images/failed_icon.svg | Failed | Any Instance Status = Failed |
| ../../_images/pending_icon.svg | Pending | Any Instance Status = Pending |
| ../../_images/pendingRemoval_icon.svg | Pending Removal | Any Instance Status = Pending Removal |
| ../../_images/deploying_icon.svg | Provisioning | Any Instance Status = Provisioning |
| ../../_images/removing_icon.svg | Removing | The DELETE action was trigger on the App |
| ../../_images/unknown_icon.svg | Unknown | Any Instance Status = Unknown, or the App is empty |

## Editing an App

### About this task

The EDIT action allows permissioned users to update an Apps metadata, Environment, Group and Owner.

### Procedure

1. Navigate to Provisioning > Apps
2. Select an App from the list to view the App detail page
3. Select EDIT
4. Update the following 

   NAME
   :   App Name

   DESCRIPTION
   :   App Description

   ENVIRONMENT
   :   App Environment

   GROUP
   :   App Group assignment

   OWNER
   :   User assigned as Owner of the App
5. Select SAVE CHANGES

## Deleting an App

### About this task

The DELETE action allows permissioned users to delete an App and, by default, all Instances within the App.

### Procedure

1. Navigate to Provisioning > Apps
2. Select an App from the list to view the App detail page
3. Select DELETE
4. The DELETE APP? confirmation modal will be displayed: 

   Remove Instances
   :   Deletes all Instances associated with the App - Enabled by Default

   Preserve Backups
   :   Preserves Backups of the Instances associated with the App - Disabled by Default

   Preserve Volumes
   :   Preserves Storage Volumes of the Instances associated with the App - Disabled by Default

   Force Delete
   :   Forces deletion of the App - Required when any Instances associated with the App are in “provisioning” state - WARNING Force deleting may cause orphaned infrastructure or resources. - Disabled by Default
5. Select DELETE to proceed with deleting the App, or CANCEL to abort the delete action.

## Exporting Configuration JSON

### About this task

To export an App Blueprint as JSON:

### Procedure

1. Navigate to Provisioning > Apps
2. Select an App from the list to view the App detail page
3. Select ACTIONS > Export
4. The App export file will be downloaded to your computer as `{app_name}.json`
