# Forge - Storage-Providers
*Source: https://forge.laravel.com/docs/storage-providers*
---
[Laravel Forge home page](https://forge.laravel.com)
Search...
⌘KAsk AI
- [Get started](https://forge.laravel.com)
- [Get started](https://forge.laravel.com)
Search...
Navigation
Basics
Storage Providers
[Documentation](/docs/introduction)[Knowledge Base](/docs/knowledge-base/servers)[API Reference](/docs/api-reference/introduction)
- [Community](https://discord.gg/laravel)
- [Blog](https://blog.laravel.com)
- [Status](https://status.on-forge.com)
##### Get Started
- [Introduction](/docs/introduction)
- [Laravel Forge CLI](/docs/cli)
- [Laravel Forge SDK](/docs/sdk)
##### Basics
- [Organizations](/docs/organizations)
- [Teams](/docs/teams)
- [Server Providers](/docs/server-providers)
- [Storage Providers](/docs/storage-providers)
- [Source Control](/docs/source-control)
- [SSH Keys](/docs/ssh)
- [Recipes](/docs/recipes)
- [API](/docs/api)
##### Servers
- [Managing Servers](/docs/servers/the-basics)
- [Server Types](/docs/servers/types)
- [Laravel VPS](/docs/servers/laravel-vps)
- [PHP](/docs/servers/php)
- [Load Balancing](/docs/servers/load-balancing)
- [Nginx Templates](/docs/servers/nginx-templates)
- [Security](/docs/servers/security)
- [Monitoring](/docs/servers/monitoring)
- [Real-Time Metrics](/docs/servers/real-time-metrics)
##### Sites
- [Managing Sites](/docs/sites/the-basics)
- [Domains](/docs/sites/domains)
- [Deployments](/docs/sites/deployments)
- [Environment Variables](/docs/sites/environment-variables)
- [Commands](/docs/sites/commands)
- [Queues](/docs/sites/queues)
- [Network](/docs/sites/network)
- [Isolation](/docs/sites/user-isolation)
- [Laravel](/docs/sites/laravel)
- [Logs](/docs/sites/logs)
##### Resources
- [Databases](/docs/resources/databases)
- [Database Backups](/docs/resources/database-backups)
- [Caches](/docs/resources/caches)
- [Background Processes](/docs/resources/background-processes)
- [Scheduler](/docs/resources/scheduler)
- [Network](/docs/resources/network)
- [Packages](/docs/resources/packages)
##### Integrations
- [Envoyer](/docs/integrations/envoyer)
- [Sentry](/docs/integrations/sentry)
- [Aikido](/docs/integrations/aikido)
##### Other
- [Support](/docs/support)
- [Changelog](/docs/changelog)
- [Abuse](/docs/abuse)
On this page
- [Introduction](#introduction)
- [Supported providers](#supported-providers)
- [Managing storage providers](#managing-storage-providers)
- [Adding a storage provider](#adding-a-storage-provider)
- [Using EC2 assumed roles](#using-ec2-assumed-roles)
- [Editing storage providers](#editing-storage-providers)
- [Deleting storage providers](#deleting-storage-providers)
- [Team permissions](#team-permissions)
Basics
# Storage Providers
Copy page
Learn about the storage providers supported by Laravel Forge for database backups.
Copy page
## [](#introduction) Introduction
Storage providers allow Laravel Forge to store your database backups on external object storage services. Once configured, a storage provider can be reused across multiple servers and backup configurations within your organization.
Storage providers are configured and managed within the [organization’s](/docs/organizations) settings.
## [](#supported-providers) Supported providers
Laravel Forge supports the following storage providers:
- [Amazon S3](https://aws.amazon.com/s3/)
- [DigitalOcean Spaces](https://www.digitalocean.com/products/spaces)
- [Hetzner](https://www.hetzner.com/storage/object-storage/)
- [Scaleway](https://www.scaleway.com/en/object-storage/)
- [OVH Cloud](https://www.ovhcloud.com/en/public-cloud/object-storage/)
- Custom (S3 Compatible)
Not all providers are 100% compatible with Amazon S3’s API. Some providers, such as OVH and Scaleway, require a custom configuration to work correctly, typically through the use of `awscli-plugin-endpoint`.
## [](#managing-storage-providers) Managing storage providers
### [](#adding-a-storage-provider) Adding a storage provider
To add a storage provider, navigate to the organization’s settings. Then, on the “Storage providers” page, click “Add provider”. Select the provider you wish to configure and provide the required credentials.
For Amazon S3, DigitalOcean Spaces, Hetzner, Scaleway, and OVH Cloud, you need to provide:
- A name for the storage provider
- The region your backups should be stored in (`eu-west-2`, `nyc3`, etc.)
- The access and secret keys that should be used to connect to the storage service
When using a custom, S3 compatible provider, you must supply:
- The service endpoint or URL
- The access and secret keys that should be used to connect to the storage service
You may also provide a default bucket and storage directory. These values can be overridden when creating a [backup configuration](/docs/resources/database-backups).
### [](#using-ec2-assumed-roles) Using EC2 assumed roles
When using Amazon S3 in combination with an EC2 server, you can choose to use the identity of the EC2 server to stream the backup to S3 without providing credentials. To use this option, enable the “Use EC2 Assumed Role” toggle when creating the storage provider.
When using Amazon S3 to store your database backups, your AWS IAM user must have the following permissions for S3:
- `s3:PutObject`
- `s3:GetObject`
- `s3:ListBucket`
- `s3:DeleteObject`
### [](#editing-storage-providers) Editing storage providers
To edit a storage provider, navigate to the organization’s settings. Then, on the “Storage providers” page, click the dropdown menu on the provider and click “Edit”. You can update any of the configuration options, including credentials.
### [](#deleting-storage-providers) Deleting storage providers
To delete a storage provider, navigate to the organization’s settings. Then, on the “Storage providers” page, click the dropdown menu on the provider and click “Delete”.
Storage providers cannot be deleted while they are in use by one or more backup configurations. You must first update or delete those backup configurations before removing the storage provider.
## [](#team-permissions) Team permissions
The ability to manage storage providers is controlled by the `storage:manage` permission.
Was this page helpful?
YesNo
[Server Providers](/docs/server-providers)[Source Control](/docs/source-control)
⌘I
[x](https://x.com/laravelphp)[github](https://github.com/laravel)[discord](https://discord.com/invite/laravel)[linkedin](https://linkedin.com/company/laravel)
