> For the complete documentation index, see [llms.txt](https://docs.unitlab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unitlab.ai/documentation/workspaces/storage-and-cloud-settings.md).

# Storage and cloud settings

Connect your own S3, Azure or Google Cloud bucket to the workspace so files stay in your storage.

By default, files you upload are stored by Unitlab. If your data must stay in your own cloud, connect a bucket in **Settings > Cloud storage**. You need the **Manage cloud storage** permission.

## Add cloud storage

1. Open **Settings > Cloud storage** and select **Add cloud storage**.
2. Choose the provider and enter the bucket details and access credentials.
3. Save. Unitlab tests the connection; if it fails, you see **Connection failed** with the reason.

<figure><img src="https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2FvmARUQ5mfQgYXSAZxDf4%2Fcloud-storage-add.webp?alt=media" alt="Add Cloud Storage dialog with the provider list and connection fields" width="560"><figcaption></figcaption></figure>

Then import files from the bucket into Data Space. Provider-by-provider setup, required permissions and CORS rules are in [Cloud providers](https://docs.unitlab.ai/documentation/data/cloud-providers.md).

## Edit or remove a connection

Each connection in the list can be edited, for example to rotate its credentials, or removed. Removing asks you to confirm first.

## Good to know

* Files imported from your cloud don't count toward upload limits. See [Billing and usage](https://docs.unitlab.ai/documentation/workspaces/capacity-limits-and-workspace-operations.md).
* Use credentials that can only read the buckets Unitlab needs. See [Cloud credential governance](https://docs.unitlab.ai/documentation/security/cloud-credential-governance.md).

## Related

[Cloud providers](https://docs.unitlab.ai/documentation/data/cloud-providers.md) · [Data upload](https://docs.unitlab.ai/documentation/data/data-upload.md)
