Access buckets and files through URLs

The Object Storage service gives each bucket and file a unique URL. This URL is managed through the shared domain *.linodeobjects.com and your files are encrypted through the use of HTTPS. By default, files are only visible by you, as their the owner through Cloud Manager or through other tools and applications using an access key with permissions to read (or read/write) the bucket.

You're also able to make these files accessible to anyone through their URLs by setting up ACLs so the files are public. This makes Object Storage great for sharing and storing unstructured data like images, documents, archives, streaming media assets, and file backups, and the amount of data you store can range from small collections of files up to massive libraries of information.

Here are the types of URLs you can use to access buckets and files:

Amazon S3 endpoint URL

The Amazon S3 endpoint URL for Object Storage can be used for accessing all of your Object Storage resources within a certain region. When used with third party tools, this URL might also be referred to as the Amazon S3 endpoint.

Use Cloud Manager or the Linode API to find the Amazon S3 endpoint hostname and add https://. For example, https://[s3-endpoint-hostname].

Bucket URL

Each bucket has its own unique URL. This URL is useful when configuring a third-party application to use a specific bucket for file storage.

A bucket URL uses the format, https://[bucket-label].[s3-endpoint-hostname].linodeobjects.com/, and includes these [variable] values:

[bucket-label]. This is the label (name) of your bucket.
[s3-endpoint-hostname]. This is the the Amazon S3 endpoint type used to create your bucket.

For example, a bucket labeled example-bucket that lives in the Atlanta data center would have the following URL:

https://example-bucket.us-southeast-1.linodeobjects.com

View a bucket's URL in Cloud Manager

Log in to Cloud Manager and select Object Storage from the left menu.
Locate the bucket you wish to use. The URL for the bucket is printed underneath the bucket label/name.

You can also click Details to view and copy the URL.

View a bucket's URL in the Linode API

Run the List Object Storage buckets operation.
In the response, locate the applicable bucket, based on its label.

Store the associated hostname value as your bucket's URL, as well as its region.

{
  "data": [
    {
      "cluster": "us-ord-1",
      "created": "2026-03-30T19:50:05",
      "endpoint_type": "E3",
      "hostname": "example-bucket.us-ord-10.linodeobjects.com", <= Store.
      "label": "example-bucket",
      "objects": 4,
      "region": "us-ord",
      "s3_endpoint": "us-ord-10.linodeobjects.com",
      "size": 188318981
    }
  ] 
}

Prepend https:// to the hostname for the full URL:

https://example-bucket.us-ord-10.linodeobjects.com

File URLs

The URLs for files (objects) within a bucket are very similar to the bucket's own URL, simply with the filename and path appended to the end. This URL is useful when sharing the file with someone or accessing it from your website.

A file URL follows the format, https://[bucket-label].[s3-endpoint-hostname].linodeobjects.com/[file], with these [variable] values:

[bucket-label]. This is the name of your bucket with the label of your bucket.
[cluster-id]. This is the unique slug identifier assigned to the data center where the bucket lives. It's listed in the Cluster URL section.
[file] This is the full path, name, and extension of your file.

For example, a file named example-file.txt stored in a bucket whose label is example-bucket, which lives the Atlanta data center would have the following URL:

https://example-bucket.us-southeast-1.linodeobjects.com/example-file.txt

View a file's URL in Cloud Manager

Log in to Cloud Manager and select Object Storage from the left menu.
Locate the bucket you wish to view and click its label/name to open it.
This opens the bucket's details page and displays a list of all the files (objects) stored within it. Locate the file you want to use and click the filename.
The URL for the file is listed at the top of the details panel.

👍
You can also view this URL using a tool like Cyberduck.

View a file's URL in the Linode API

Run the List Object Storage bucket contents operation, using the target bucket's label and its region.
In the response, locate the applicable bucket, based on its label.

Store the associated name value as your bucket's URL.

{
  "data": [
    {
      "etag": "1a234b56c78d90ef1g2h3456i7j89kl",
      "last_modified": "2026-01-01T01:23:45",
      "name": "example-file.txt", <= Store.
      "owner": "a234b56c78d90ef1g2h3456i7j89klm",
      "size": 123
    }
  ],
  "is_truncated": true,
  "next_marker": "cd123e45-f678-9012-34g5-67h89i0jk1l2.345878.901"
}

Append the name to the full URL for your bucket:

https://example-bucket.us-ord-10.linodeobjects.com/example-file.txt

Signed URLs

A signed URL gives anyone with the URL access to a file for a certain period of time. This is very useful when you want to share a document or file with someone, but don't wish to make the URL permanently accessible or able to be guessed by others. You can generate a signed URL using these tools:

Linode CLI
s3cmd.

Here's an example of a signed URL:

https://us-southeast-1.linodeobjects.com:443/example-bucket/example-file.txt?Signature=NUXLA378K28nMKgnaIcYjGroMXw%3D&Expires=1644600958&AWSAccessKeyId=YFULT4UZZULG82GFPQE2&x-amz-meta-mtime=1644590299284&x-amz-meta-storage-class=STANDARD

Website URLs

You can configure a bucket to serve a static websiteCJAR_DASH_LONGa website only containing static files like html, css, client-side javascript, images, and other non-dynamic resources.

A website URL follows the format,https://[bucket-label].website-[cluster-id].linodeobjects.com/, and includes these [variable] values:

[bucket-label]. This is the name you've given to your bucket.

[cluster-id]. This is the unique slug identifier assigned to the data center where the bucket lives. It's listed in the Cluster URL section.

For example, if you have configured a website on a bucket labeled example-bucket within the Atlanta data center would have the following URL:

https://example-bucket.website-us-southeast-1.linodeobjects.com

For more information on hosting a static website with Object Storage, see Deploy a Static Site using Hugo and Object Storage.

Custom URLs

So far, this guide has covered obtaining URLs that use the shared domain *.linodeobjects.com. You can also configure a bucket to use a custom domain, such as assets.example.com. To do this, see Configure a Custom Domain (with a TLS/SSL Certificate).

This is only supported for E0 and E1 endpoint types.