> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorules.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployments

> Configure cloud storage providers for deploying your decision rules.

Deployments connect your GoRules projects to cloud storage, enabling you to publish rules for consumption by your applications.

## Supported providers

| Provider             | Description                   |
| -------------------- | ----------------------------- |
| AWS S3               | Amazon Simple Storage Service |
| Azure Storage        | Microsoft Azure Blob Storage  |
| Google Cloud Storage | Google Cloud Platform storage |

## Creating a deployment

1. Go to Organisation settings → Deployments
2. Click "Add deployment"
3. Enter deployment details:
   * **Name**: Descriptive name (e.g., "Production S3", "Staging Azure")
   * **Description**: Optional details about the deployment
4. Select a provider and configure credentials

### AWS S3 configuration

| Field                  | Description                                                 |
| ---------------------- | ----------------------------------------------------------- |
| Authenticate using IAM | Use instance role instead of credentials                    |
| Region                 | AWS region (e.g., `us-east-1`)                              |
| Bucket                 | S3 bucket name                                              |
| Endpoint               | Custom endpoint for S3-compatible services (optional)       |
| Path                   | Subdirectory within bucket (optional)                       |
| Force path style       | Enable for S3-compatible services requiring path-style URLs |

### Azure Storage configuration

| Field                  | Description                                           |
| ---------------------- | ----------------------------------------------------- |
| Authenticate using IAM | Use managed identity                                  |
| Blob service URL       | Format: `https://{accountName}.blob.core.windows.net` |
| Container              | Blob container name                                   |
| Path                   | Virtual directory path (optional)                     |

### Google Cloud Storage configuration

| Field                  | Description                             |
| ---------------------- | --------------------------------------- |
| Authenticate using IAM | Use service account attached to compute |
| Bucket                 | GCS bucket name                         |
| Path                   | Object prefix (optional)                |

## IAM authentication

All providers support IAM-based authentication, eliminating the need to store credentials in GoRules:

**AWS**: Attach an IAM role to your GoRules compute instance with S3 permissions.

**Azure**: Enable managed identity and grant Storage Blob Data Contributor role.

**GCS**: Attach a service account with Storage Object Admin permissions.