Getting Started

Adding a DigitalOcean Source

A DigitalOcean Source connects to an existing DigitalOcean Space. imgix connects using the credentials you supply, so your DigitalOcean assets don't have to be public.

Setting Up Your DigitalOcean Source

  1. Go to the Sources page (opens in a new tab) in the imgix dashboard and click the New Source button.

  2. Select DigitalOcean from the How do you store your media? radio options.

Screenshot-DigitalOcean source setup

  1. Fill in the details for your DigitalOcean Source.

Screenshot-DigitalOcean source setup

Note: We strongly recommend creating a set of access keys specifically for imgix to access your Space with. Keep in mind that imgix only requires Read and List permissions to begin serving your assets. For more information on how to generate your Access and Secret Access Keys or where to find other Space information, see the DigitalOcean Guide documentation.

  • Access Key ID (opens in a new tab): The DigitalOcean access key of the deployment credentials you want imgix to connect with.
  • Secret Access Key (opens in a new tab): The DigitalOcean secret key of the deployment credentials you want imgix to connect with.
  • Space Name: The name of the DigitalOcean Space containing the assets you want imgix to connect to.
  • Endpoint URL (opens in a new tab): The S3 endpoint URL used by your DigitalOcean Space.
  • Region: The region of your DigitalOcean Space
  • Prefix (optional): The folder prefix you want to resolve to (if it exists). The prefix is prepended to the asset path before resolving the asset in DigitalOcean. By default the asset path is /.
  1. Name the Subdomain you'd like to use as the base URL for your assets.

Screenshot-DigitalOcean source setup

Note: The subdomain name you choose is unique to your Source and can't be re-used. If you're setting up a Source with a lot of customization (particularly a Custom Domain), choose the name you plan to use going forward.

  • If you are editing an existing Source and the Video API is enabled, the imgix Video Subdomain field will be visible. This field automatically inherits the value from your imgix Image Subdomain and cannot be modified without changing the Image Subdomain.
  1. Click the Save button on Step #3 to queue your Source for deployment.

Screenshot-DigitalOcean source setup

DigitalOcean Guide

We strongly recommend creating DigitalOcean access keys specifically for imgix to access your Space with. All DigitalOcean credentials are stored using industry standard cryptographic best practices.

Advanced Settings

See the Advanced Source Settings for information about setting up custom domains, defaults, and cache TTL options.


To upload images and videos directly to your cloud-storage-backed DigitalOcean Source, you will have to create a separate set of upload_credentials. To upload to your Source directly through Asset Manager, you will also have to update your bucket’s CORS configuration. Uploading should only be set up post-Source-deployment.

imgix’s rendering service does not need Write permissions to fetch assets; therefore, we highly recommend that you do not use the same credentials for your upload_credentials and your deployment_credentials.