# DigitalOcean Spaces

Easily leverage your DigitalOcean account into a strong backup storage.

## How to connect your DigitalOcean Spaces to SimpleBackups

### 1. Create your DigitalOcean Spaces

- [Sign in to your DigitalOcean account](https://cloud.digitalocean.com/login)
- [Create a new "Spaces"](https://cloud.digitalocean.com/spaces/new) using the create menu at the top right

![DigitalOcean Spaces screenshot 1](https://simplebackups.com/docs/docs-assets/www-notion-so/14a80b3c8027219f7855.png)

- Fill in the "Create Spaces" form
- Pick the region you need (think about GDPR rules, if you're an EU company)
- Select "Restrict File Listing"
- Pick a name you like and link it to your DigitalOcean project (doesn't really affect us)

That's it! Your DigitalOcean Spaces is now created.

![DigitalOcean Spaces screenshot 2](https://simplebackups.com/docs/docs-assets/www-notion-so/2403ea72c45c25fa5eb6.png)

_Don't leave the DigitalOcean interface, we'll now have to create your credentials._

### Information You'll Need In Step 3

- Your **"Spaces" name**, in this case "myacme-space"
- Your **"Spaces" Region**, in this case "San Francisco 2", which you can also see in your DO Space url

### 2. Create your DigitalOcean Credentials

- Click **Manage Keys** on the right hand side of the **Spaces** screen or directly go to [https://cloud.digitalocean.com/account/api/tokens](https://cloud.digitalocean.com/account/api/tokens)
- Next to **Spaces access keys**, click **Generate New Key** then add a name for your key and click the check mark.
- A new **Key** and **Secret** will be generated. The shorter one is the Access Key and the longer one is the Secret Key. Use these two values when adding your _DigitalOcean Spaces_ account to SimpleBackups.

An overview of the selections made in the previous steps:

![DigitalOcean Spaces screenshot 3](https://simplebackups.com/docs/docs-assets/media-helpkit-co/f44ad98fc5006303f5a7.png)

![DigitalOcean Spaces screenshot 4](https://simplebackups.com/docs/docs-assets/media-helpkit-co/75f7985aef28af226288.png)

### 3. Connect your Space to SimpleBackups

- Log into SimpleBackups and head to the [connect your storage](https://my.simplebackups.com/storage/create) page
- Pick **"DigitalOcean Spaces"** as storage provider and fill in the "Connect your storage" form with the information from step 1 and 2.

![DigitalOcean Spaces screenshot 5](https://simplebackups.com/docs/docs-assets/www-notion-so/7559d613f0787c01d18d.png)

You'll have to input :

- **Key**: Key described in (step 2)
- **Secret**: Secret described in (step 2)
- **Region**: Spaces region described in (step 1)
- **Bucket**: Spaces name described in (step 1)
- Give your storage a **name** (usually we like to use the Spaces name) and click on "Save new storage".

## Limitations

### Cold storage buckets reject non-ASCII filenames

DigitalOcean Spaces **cold storage** buckets reject object names containing non-ASCII or special characters (accents, em/en dashes, smart quotes, etc.) with `400 InvalidObjectName: The specified object name is not valid`. Affected files fail to sync while the rest of the backup succeeds. Standard (hot) Spaces do not have this restriction.

When using DigitalOcean Spaces as a backup **destination**, use a standard Space. If a cold-storage destination is required, either rename source files to ASCII-only, or enable **"Ignore sync I/O errors"** to skip the affected files.

**Info:**
This is a DigitalOcean-side limitation of the cold-storage tier, not a SimpleBackups limitation.