---
title: "Custom DigitalOcean Spaces Storage"
description: "Step-by-step tutorial on how to set up a DigitalOcean Spaces Storage integration for the Topol Plugin."
url: https://docs.topol.io/email-editor/guide/custom-digitalocean-spaces-storage.html
---

# Custom DigitalOcean Spaces Storage

> **The Custom storage feature is available with the Plugin Expansion plan and higher.**
>
> If you're on the Plugin for Startup plan, consider upgrading to access this feature. For more details, visit our [pricing page](https://topol.io/pricing) or contact support.

The Custom Cloud Storage feature in the Topol Plugin lets you connect your own storage provider. Alongside AWS S3, Google Cloud Storage, and Cloudflare R2, you can also use DigitalOcean Spaces, an S3-compatible object storage. This tutorial walks through that setup step by step.

Throughout this guide, you will collect several values that you'll need at the very end (your **bucket name**, **region**, **Origin Endpoint**, **access key**, and **secret key**). Save each one somewhere safe as you go.

## How to configure Custom DigitalOcean Spaces Storage

**1)** Sign up at [https://cloud.digitalocean.com/](https://cloud.digitalocean.com/) and create a new **Spaces bucket**. In the top bar, click **Create** and, under the **STORAGE** column, choose **Spaces Object Storage**.

![DigitalOcean Create menu with Spaces Object Storage](https://docs.topol.io/custom-storage/do/do-1.png)

**2)** Leave **Standard Storage** selected (CDN support, no minimum retention period). Further down the page, select a **region** and enter a **bucket name**, then click **Create a Spaces Bucket**.

![Choose Standard Storage, region, and bucket name](https://docs.topol.io/custom-storage/do/do-2.png)

> **In this example the bucket is named topol-plugin and the region is fra1. Save your own values for the final step.**
>
> In this example the bucket is named `topol-plugin` and the region is `fra1`. Save your own values for the final step.

**3)** After it is created, the bucket detail opens with the **Files** and **Settings** tabs. In the top-right corner there is an **Origin Endpoint** field showing your storage address. Click **Settings**.

![Bucket detail with Files and Settings tabs and the Origin Endpoint field](https://docs.topol.io/custom-storage/do/do-3.png)

**4)** In **Settings**, scroll down to the **Access Keys** section and click **Create Access Key**.

![Settings with the Create Access Key button in the Access Keys section](https://docs.topol.io/custom-storage/do/do-4.png)

**5)** In the modal window that appears, select this bucket and switch its permissions from **Read** to **Read/Write/Delete**. Then click **Create Access Key**.

![Create Access Key modal with the bucket set to Read/Write/Delete](https://docs.topol.io/custom-storage/do/do-5.png)

> **The plugin needs to write and delete files as well, so Read/Write/Delete is required. Read alone is not enough.**
>
> The plugin needs to write and delete files as well, so **Read/Write/Delete** is required. **Read** alone is not enough.

**6)** The key is created and displayed. Copy the **Access Key ID** and the **Secret Key**, and save both somewhere safe.

![Created access key showing the Access Key ID and Secret Key](https://docs.topol.io/custom-storage/do/do-6.png)

> **The Secret Key is shown only once. After the window is closed it cannot be viewed again; the only option is to regenerate the key (Regenerate key). Save it right away.**
>
> The **Secret Key is shown only once.** After the window is closed it cannot be viewed again; the only option is to regenerate the key (**Regenerate key**). Save it right away.

**7)** Go back to **Settings** and, next to the **CORS Configurations** section, click **Add**.

![Settings with the Add button next to CORS Configurations](https://docs.topol.io/custom-storage/do/do-7.png)

**8)** In the **Advanced CORS Options** window, fill in a single rule:

-   **Origin**: enter one of the URLs from the table below.
-   **Allowed Methods**: tick **GET**, **PUT**, and **HEAD**.
-   **Allowed Headers**: click **\+ Add Header** and add **one** header with the wildcard `*`.
-   **Access Control Max Age**: enter `3600`.

Then save it with **Save CORS Configuration**.

![Advanced CORS Options with Origin, Allowed Methods, Allowed Headers, and Access Control Max Age](https://docs.topol.io/custom-storage/do/do-8.png)

Add these three rules:

| #   | Origin | Allowed Methods | Allowed Headers | Max Age |
| --- | --- | --- | --- | --- |
| 1   | `https://d3ayqk5orocicw.cloudfront.net` | GET, PUT, HEAD | `*` | 3600 s |
| 2   | `https://v4.email-assets.topol.io` | GET, PUT, HEAD | `*` | 3600 s |
| 3   | `https://v3.email-assets.topol.io` | GET, PUT, HEAD | `*` | 3600 s |

> **DigitalOcean adds only one origin per rule. Repeat the process three times: one rule for each address. The order of the rules can be changed by drag & drop.**
>
> DigitalOcean adds **only one origin per rule**. Repeat the process **three times**: one rule for each address. The order of the rules can be changed by drag & drop.

**9)** The top of the bucket detail shows everything needed for the Topol setup:

-   **Name**: next to the bucket icon.
-   **Region**: in the metadata row (`fra1`).
-   **Origin Endpoint**: in the field on the right; copy the address using the **Copy** button.

![Bucket detail with the name, fra1 region, and the Origin Endpoint field](https://docs.topol.io/custom-storage/do/do-9.png)

> **The Origin Endpoint has the form https://<bucket-name>.fra1.digitaloceanspaces.com.**
>
> The Origin Endpoint has the form `https://<bucket-name>.fra1.digitaloceanspaces.com`.

## Set your DigitalOcean Spaces credentials for the API Token in TOPOL

The remaining steps happen in the Topol app, using the values you saved above.

**1)** Log in to your Topol account at [https://app.topol.io/](https://app.topol.io/). The **API Tokens** tab is selected by default.

**2)** Select the API Token where you want to set up your own DigitalOcean Spaces storage and switch to the **Configuration** tab.

**3)** In the **Custom storage** section, click **Set up DigitalOcean Spaces storage**.

![Custom storage section in the API Token Configuration tab](https://docs.topol.io/custom-storage/custom-storage-options.png)

**4)** A modal will appear. Fill in the values you saved during the setup:

-   **Bucket name**: the name of your Spaces bucket.
-   **Region**: the region of your bucket (for example, `fra1`).
-   **Access key**: the Access Key ID you saved earlier.
-   **Secret key**: the Secret Key you saved earlier.
-   **Public URL**: your bucket's **Origin Endpoint** (for example, `https://<bucket-name>.fra1.digitaloceanspaces.com`).

![Set up your own DigitalOcean Spaces bucket modal](https://docs.topol.io/custom-storage/do/do-10-setup-modal.png)

**5)** Click **Finish setup**.

**Setup complete. The plugin now uploads files to your Spaces bucket.**

If you hit any issues, contact our [support](https://topol.io/contact).