> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cloud/files/integrations/providers.md).

# Providers

The storage providers you can connect to Files, and how to pick one.

**Where:** Files → Integrations → **Add New Integration** · `/projects/<project>/files/integrations/pick`

**Add New Integration** opens the picker **Select "Files" Integration**. Each card has **Connect**, which opens the provider's form; **View documentation** and **See examples** point at old documentation addresses that do not open today — use the pages below.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-e96003bb36cde583b0d7200ddfca81786911ffca%2Fproviders-1.png?alt=media" alt="Select Files Integration: the cards AWS S3, Google Drive, Google Cloud Storage and Azure Blob Storage, each with Connect, View documentation and See examples"><figcaption><p>The provider picker.</p></figcaption></figure>

## Columns, search and filters

| Card                                                                                 | What it asks for                                                              | Where the files live             |
| ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | -------------------------------- |
| [AWS S3](/codemash/cloud/files/integrations/providers/aws-s3.md)                     | Bucket name, region, and a Cross-Account Role ARN or an IAM user's access key | Your S3 bucket                   |
| [Google Drive](/codemash/cloud/files/integrations/providers/google-drive.md)         | A service-account JSON key and, optionally, a root folder id                  | A Google Drive folder            |
| [Google Cloud Storage](/codemash/cloud/files/integrations/providers/google-cloud.md) | Bucket name and a service-account JSON key                                    | Your Cloud Storage bucket        |
| [Azure Blob Storage](/codemash/cloud/files/integrations/providers/azure-blob.md)     | Container name and a storage-account connection string                        | Your Blob container              |
| [Local](/codemash/cloud/files/integrations/providers/local.md)                       | A folder under the server's files root                                        | The disk of a self-hosted server |

The picker shows only what the server accepts: **Local** appears only on a self-hosted server whose operator set a files root (it is never on the managed service). No search and no filters.

## What you can do here

* [AWS S3](/codemash/cloud/files/integrations/providers/aws-s3.md)
* [Google Drive](/codemash/cloud/files/integrations/providers/google-drive.md)
* [Google Cloud Storage](/codemash/cloud/files/integrations/providers/google-cloud.md)
* [Azure Blob Storage](/codemash/cloud/files/integrations/providers/azure-blob.md)
* [Local](/codemash/cloud/files/integrations/providers/local.md)
* After saving: [test](/codemash/cloud/files/integrations/test.md), [set as default](/codemash/cloud/files/integrations/set-default.md), [disable or delete](/codemash/cloud/files/integrations/disable.md).

## Do it from code

```ts
const { availableProviders } = await norbix.hub.files.getFilesIntegrations();
console.log(availableProviders); // [ 'Local', 'AwsS3', 'AzureBlobStorage', 'GoogleCloudStorage', 'DropBox', 'GoogleDrive' ]
```

```sh
norbix hub files integrations get --pageSize 10
```

`availableProviders` also names **DropBox**, which has no card in Cloud. The client setup is on the [Files page](/codemash/cloud/files.md#use-it-from-code). API: [Get Files Integrations](/codemash/api-reference/files/integrations/get-files-integrations.md) · [Save Files Integration](/codemash/api-reference/files/integrations/save-files-integration.md)
