# How do I set up with DigitalOcean Spaces?

**1. Sign up for a DigitalOcean Account**

To use DigitalOcean Spaces, you will first need a DigitalOcean account. To sign up, go to the
[DigitalOcean web page](https://www.digitalocean.com/) and create your account.

**2. Locate your credentials**

To locate the credentials for your account, you will need to:

* Sign in to your DigitalOcean account
* Hover over Manage
* from the drop down menu select [API](https://cloud.digitalocean.com/account/api/)
* scroll to the "Spaces access keys" section
* click on "Generate New Key"
* Take note of both the **Access Key ID** (`YOUR_DIGITALOCEAN_SPACES_KEY`) and **Secret Access Key**
  (`YOUR_DIGITALOCEAN_SPACES_SECRET`)

**3. Create a bucket**

To create a DigitalOcean bucket, use [Spaces default API](https://cloud.digitalocean.com/spaces/s)
online, or use a local client that supports the Spaces API. We recommend any of the following:

* OSX: [Transmit](https://panic.com/transmit/)
* Windows: [Cyberduck](https://cyberduck.io/)
* Linux: [s3cmd 2.sx](https://www.digitalocean.com/docs/spaces/resources/s3cmd/)

Make sure to take note of the name of your **Spaces Name** (`YOUR_DIGITALOCEAN_SPACE_NAME`) and
**Space Region** (`YOUR_DIGITALOCEAN_SPACE_REGION`) after you create it.

**4. Use the bucket with Transloadit Templates**

Assuming you have signed up for Transloadit, proceed to
[Template Credentials](https://transloadit.com/c/template-credentials/) then under "Adding new
Credentials", select "DigitalOcean" and input the relevant information from the earlier steps.

The following is an example of a simple <dfn>Template</dfn> for testing the connection to your
DigitalOcean account.

```json
{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "robot": "/digitalocean/store",
      "use": ":original",
      "credentials": "YOUR_DIGITALOCEAN_CREDENTIALS"
    }
  }
}
```

To see if it works, in the created Template's Testing section click "Toggle Testing Area" and upload
an item.

### More

* For more details about <dfn>Template</dfn> and security, see our
  [Template documentation](/docs/topics/templates.md).
* For more information on saving to Spaces, such as how to customize file names, see the
  [🤖/digitalocean/store documentation](/docs/robots/digitalocean-store.md).