Spaces Quickstart

Spaces Object Storage is an S3-compatible object storage service. Spaces buckets let you store and serve large amounts of data, and the built-in CDN minimizes page load times and improves performance.

Create a Bucket

1. From the control panel, click Create in the top right, and then Spaces.
2. Optionally, enable the Spaces CDN at no extra cost.
3. Choose a name, a datacenter region, and the file listing permissions of your Space.
4. Click Create a Space. This takes you to the root of your new Space.

Upload and Delete Files

To upload a file:

1. From the Files tab of your bucket, you can add files by dragging and dropping. To use the file selection tool instead, click Upload Files.
2. After you have selected your files for upload, choose their permissions. By default, it’s set to Private.
3. Click Upload File.

To delete a file:

1. In your Spaces page, click the file’s More menu and select Delete.
2. Confirm the deletion.

Manage File Permissions

You can check the permissions on files in your bucket by mousing over the filename. The tooltip that opens shows the Permission, which is either Public or Private.

To change a file’s permissions:

1. In your Spaces page, click the file’s More menu and select Manage Permissions.
2. Choose Public or Private and click Update.

Create and Delete Folders

You can organize files using folders. To create a new folder:

1. Click the New Folder button from your bucket.
2. Enter a name for the folder and click the blue check mark.

To upload a folder:

1. From the Files tab of your bucket, click Upload File. From here, you can drag and drop nested directory structures.
2. After you have selected your folders for upload, choose their permissions. By default, it’s set to Private.
3. Click Upload.

To delete a folder:

1. In your Spaces page, click the folder’s More menu and select Delete.
2. Confirm the deletion.

All the contents in a deleted folder are also deleted.

Enable the CDN

You can enable the CDN when creating a new bucket. To enable the CDN on an existing bucket:

1. From the Settings tab of your Space, in the CDN (Content Delivery Network) section, click Edit.
2. Click Enable CDN, choose your TTL, and add any subdomains.
3. Click Save.

Warning

We do not recommend or support using multiple CDNs from separate vendors with your Spaces buckets (such as the Spaces built-in CDN and another vendor’s CDN), as it can cause performance issues and be complex to manage.

Delete a Space

1. From the Settings tab of your Space, select Destroy.
2. Click the red Destroy button, then the red Confirm button.

This destroys the bucket and all of its contents.