1. Articles
  2. Public Cloud Services
  3. Object Storage
  4. Tutorials

Articles in this section

Object Storage - Hosting a static website in an Object Storage bucket

Avatar
Stephanie R.
  • Updated

Learn how to create, configure, and activate a static website hosted in an Object Storage bucket.

 

Requirements

  • an Object Storage bucket with an ACL public-read
  • your static resources (HTML, CSS, images, js, etc.)

 

Instructions

Step 1: Uploading website resources

In Object Storage, a bucket is a flat container of objects. It does not provide any hierarchical organization as the file system on your computer does. However, you can create a logical hierarchy by using object key names that imply a folder structure.

Example:

  • index.html: Object is the root of the bucket.
  • doc/page1.html: Object is in a subfolder.
NOTE:
  • HTML pages must be uploaded with text/html as their ContentType.
  • CSS files must be uploaded with text/css as their ContentType.
  • Make your bucket content publicly available, i.e. all resources must have ACL "public-read".

 

Step 2: Setting the website configuration for a bucket

The bucket hosting the website and its contents must be publicly accessible, i.e. with READ permission set for all users.

Example:

Using the predefined PUBLIC-READ ACL at the bucket level:

aws --profile user-aws s3api put-bucket-acl --bucket my-website --acl public-read

Applying the predefined PUBLIC-READ ACL on all the objects:

#!/bin/bash
declare -a output=($(aws s3api list-objects-v2 --bucket my-website --query='Contents[].Key' | jq -r '.[]'))
for value in "${output[@]}"
do
    aws s3api put-object-acl --bucket my-website --key $value --acl public-read
done

 

Step 3: Setting the website configuration for a bucket

To activate website hosting, you will have to upload a website configuration.

Example:

aws --profile user-aws s3 website s3://my-website/ --index-document index.html --error-document error.html

Or

aws --profile user-aws s3api put-bucket-website --bucket my-website --website-configuration file://website-conf.json

If you use the AWS low-level commands with website-conf.json:

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

 

Step 4: Testing the endpoint

Once the website configuration has been successfully uploaded, you can test the endpoint in your web browser. The default endpoint will depend on the region of your bucket.

http://{bucket-name}.s3-website.{region}.io.cloud.ovh.us
If you want to use a custom endpoint, you will have to provide your own domain name.
NOTE:
  • Make sure the region you are hosting your bucket in supports the storage class you choose. You can check the list of supported storage classes by region here.
  • By default, OVHcloud Object Storage website endpoints do not support HTTPS. To enable HTTPS, you can use OVHcloud Load Balancer to proxy your website. For more information, see the "Go further" section of this guide.

 

Go further

For more information and tutorials, please see our other Object Storage support guides or explore the guides for other OVHcloud products and services.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on this link to get a quote and ask our Professional Services experts for a custom analysis of your project.

*S3 is a trademark filed by Amazon Technologies, Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies, Inc.

Related articles