Setting Up a Website

To host a simple, new website

1. Create a bucket and configure it as a website:

   1. Go to the Amazon S3 console.

   2. Create a bucket. Note the region where you created the bucket. In this procedure you create a bucket in the US Standard region.

      If you have your registered domain name, for additional information about bucket naming, see Customizing Amazon S3 URLs with CNAMEs and Customizing Amazon S3 URLs with CNAMEs.

   3. In the bucket Properties pane, click the Website configuration tab.

   4. Select the Enabled check box.

   5. In the Index Document text box, add the required index document name (index.html). Instructions to upload your index document are provided in the following steps.

   6. Click Save to save the website configuration.

2. Add a bucket policy to make your bucket content publicly available.

   The content you want to served via the website endpoint must be publicly readable. You can grant the necessary permissions by adding a bucket policy or by changing each object's ACL. Here we describe adding a bucket policy.

   1. In bucket Properties pane, click the Permissions tab.

   2. Click Add Bucket Policy.

   3. Copy the following bucket policy and paste it in the Bucket Policy Editor.

      {
        "Version":"2008-10-17",
        "Statement":[{
      	"Sid":"PublicReadForGetBucketObjects",
              "Effect":"Allow",
      	  "Principal": {
                  "AWS": "*"
               },
            "Action":["s3:GetObject"],
            "Resource":["arn:aws:s3:::example-bucket/*"
            ]
          }
        ]
      }

   4. Update the policy by providing your bucket name, instead of the example-bucket.

   5. Click Save.

3. Upload an index document.

   Amazon S3 serves this index document whenever a user specifies the URL for the root of your website, or a subfolder. For example, when a customer requests http://example-bucket.s3-website-us-east-1.amazonaws.com/, Amazon S3 returns the content of your index document at the root of the website, http://example-bucket.s3-website-us-east-1.amazonaws.com/index.html.

   1. Create a document.

      The file name (index.html) must be same as the Index Document you provided when configuring your bucket as a website in the preceding steps.

   2. Using the console, upload the index document to your bucket.

      For information on uploading an object, go to Uploading Objects into Amazon S3.

4. Test your website.

   1. Enter the following URL in the browser. Specify your bucket name and the region specific endpoint name (see Website Endpoints ).

      This is the URL to the root of your website. In response, Amazon S3 returns the index.html page you added to the bucket.

      http://example-bucket.s3-website-region.amazonaws.com