About 5 minutes

How to use Aktar with DigitalOcean Spaces

DigitalOcean Spaces is S3-compatible object storage with a built-in CDN. Aktar's DigitalOcean Spaces preset connects with a Spaces access key.

What you need

  • A DigitalOcean account
  • Aktar installed on your Mac

Step by step

  1. 1

    Create a Space

    In the DigitalOcean control panel, create a Spaces bucket in a datacenter near you, for example fra1. Enabling the CDN is recommended for public links.

  2. 2

    Make uploaded files publicly readable

    New files in Spaces are private by default and Aktar doesn't set per-file permissions, so public reads have to come from the bucket, for example a bucket policy that allows s3:GetObject. DigitalOcean's Spaces documentation describes how to apply one. Test Connection in the last step tells you whether it works.

  3. 3

    Create an access key

    Create a Spaces access key with read and write access to your bucket and copy the Access Key and Secret Key. The secret is only shown once.

  4. 4

    Add the destination in Aktar

    In Settings → Destinations → Add Destination, choose DigitalOcean Spaces and enter the values below.

  5. 5

    Test and save

    Click Test Connection, then Save.

Settings in Aktar

Enter these values in Settings → Destinations → Add Destination. Field names match the app.

FieldExample value
ProviderDigitalOcean Spaces
Endpointhttps://fra1.digitaloceanspaces.comYour Space's region.
Regionfra1
Access Key IDDO00…
Secret Access Key••••••••
Bucketyour-space
Public Base URLyour-space.fra1.cdn.digitaloceanspaces.comCDN address, or your custom CDN domain.

Tips

  • Use the CDN endpoint as Public Base URL so links are cached close to your viewers.
  • Spaces supports custom domains on the CDN, so links can use your own domain.

Troubleshooting

Links return 403

The uploaded files aren't publicly readable. Apply a public read policy to the bucket. See Access Denied errors.

Test Connection can't find the bucket

Check that the endpoint region (for example fra1) matches the region your Space was created in.

Still stuck?Browse the FAQ or ask on GitHub.