# App Installation

Installing apps in your project makes their blocks available for use in your flows. This guide covers the complete installation process.

## Installation Process
[Section titled “Installation Process”](#installation-process)
### Step 1: Access the App Registry
[Section titled “Step 1: Access the App Registry”](#step-1-access-the-app-registry)
 1. Navigate to your project view
 1. Click **Apps** in navigation
 1. Select **Registry** to browse available apps

![App Registry](/images/app-registry.png)

### Step 2: Select Your App
[Section titled “Step 2: Select Your App”](#step-2-select-your-app)
Browse available apps and click the one you want to install.

### Step 3: Create the Installation
[Section titled “Step 3: Create the Installation”](#step-3-create-the-installation)
 1. Click **Install** on the selected app
 1. Provide a descriptive name for this installation
 - Use names indicating purpose (e.g., “AWS Production”, “Slack Engineering Team”)
 - Helpful when having multiple installations of the same app
 1. Click **Install** in bottom right corner

App installation is created but remains in **Draft** state until configured.

### Step 4: Configure the App
[Section titled “Step 4: Configure the App”](#step-4-configure-the-app)
Every app has specific configuration requirements:

 1. Click **Config** tab in your new installation
 1. Read configuration instructions carefully - specific to each app
 1. Instructions guide you through:
 - Required API keys or authentication tokens
 - Endpoint URLs or connection settings
 - Permission requirements
 - External setup needed in target service

![App Configuration](/images/app-configuration.png)

### Step 5: Apply Configuration
[Section titled “Step 5: Apply Configuration”](#step-5-apply-configuration)
 1. Follow step-by-step instructions in Config tab
 1. Enter all required configuration values
 1. Complete external setup (like creating API keys in target service)
 1. Click **Save** to store configuration

### Step 6: Confirm Installation
[Section titled “Step 6: Confirm Installation”](#step-6-confirm-installation)
 1. Review configuration settings for accuracy
 1. Click **Confirm** in top right to finalize installation
 1. App begins activation process

### Step 7: Verify Installation
[Section titled “Step 7: Verify Installation”](#step-7-verify-installation)
 1. Navigate to **Overview** tab
 1. Check app state changed from **Draft** to **Ready**
 1. If installation failed, state changes to **Failed** - follow error messages for resolution

### Step 8: Use in Flows
[Section titled “Step 8: Use in Flows”](#step-8-use-in-flows)
Once app shows **Ready** status, blocks are available:

 - Open any flow in your project
 - App’s blocks appear in left sidebar in ‘Apps’ tab
 - Drag and drop onto canvas like any other block

### Getting Help
[Section titled “Getting Help”](#getting-help)
If you encounter installation issues:

 1. Review app’s specific documentation in Config tab
 1. Check app’s error messages for specific guidance
 1. Verify external service configuration and permissions
 1. Contact support if problems persist