For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Create a Bucket

To create a bucket:

1. From the DigitalOcean Control Panel, in the left menu, click Spaces Object Storage, and then click Create Bucket to open the Create a Spaces Bucket page.

2. Under the Choose a datacenter region section, select a region. Choose a region close to your users or the resources that access the bucket, such as Droplets, to reduce latency.

3. Under the Choose a storage type section, select Standard Storage for frequently accessed data and active workloads, or Cold Storage for infrequently accessed data such as backups and archives.

   Spaces Cold Storage buckets can only be created in the control panel, and the storage class cannot be changed after creation.

4. Optionally, under the Content Delivery Network (CDN) section, enable the Spaces CDN to cache content closer to users and improve download performance, at no additional cost.

   Note

   Spaces Cold Storage buckets do not support CDN integration or custom CDN endpoints. To use CDN caching or custom subdomains, create a Spaces Standard Storage bucket instead. For more information, see Spaces Limits.

5. Under the Finalize section, in the Choose a unique Spaces Bucket name sub-section, choose a bucket name, which must be between 3-63 characters long and may contain dashes. This cannot be changed after creation.

6. In the Select a project sub-section, click the project dropdown menu to choose a project for your bucket to live in.

7. Under the Summary section on the top right, review your bucket configurations and pricing.

8. Click Create a Spaces Bucket.

Upload a File

To upload a file:

1. From the DigitalOcean Control Panel, in the left menu, click Spaces Object Storage, and then in the Buckets tab, click the bucket you want to add a file to.
2. From the bucket’s Files tab, on the right, either drag-and-drop the file into the files list, or click Upload to open your local filesystem, and then select the file you want to upload. This opens the Upload files window where you can set your file’s permissions.
3. Under Select file permissions, choose Private, which restricts access to authorized users, or Public, which allows anyone with the file URL to access the file. By default, files are Private.
4. Click Upload.

For additional guidance on managing files and folders, see Add and Remove Files and Use Folders.

Enable the CDN

You can either enable the CDN when creating a Space or on an existing Space:

1. From the DigitalOcean Control Panel, in the left menu, click Spaces Object Storage, and then in the Buckets tab, click the bucket you want to enable CDN for.
2. In the bucket’s overview page, click its Settings tab.
3. Under the CDN (Content Delivery Network) section, on the right, click Edit, and then click Enable CDN.
4. Optionally, under the Custom Subdomain sub-section, click Add a New Subdomain to set up a custom domain for your bucket.
5. Under the Edge Cache TTL sub-section, choose how long the CDN caches content before checking for updates (which ranges from 1 min, 10 min, 1 hour, 1 day, and 1 week). The default is 1 hour, as it balances performance and content freshness for most workloads.
6. Click Save.

See CDN Best Practices and Enable the Spaces CDN for CDN configuration details.

Delete a Bucket

Deleting a Space permanently removes the bucket and all of its contents. The deletion process can take several days depending on the amount of data. During this time, the bucket name cannot be reused, and you are not billed for the Space.

To delete a bucket:

1. From the DigitalOcean Control Panel, in the left menu, click Spaces Object Storage, and then in the Buckets tab, click the bucket you want to delete.
2. In the bucket’s overview page, click its Settings tab.
3. Under the Delete this Spaces Bucket sub-section, on the right, click Delete to open the Delete Spaces Bucket window.
4. Enter the name of your bucket to confirm deletion.
5. Click Delete.