---
title: "Host a Static Website on Amazon S3"
description: "A static website hosted on AWS S3"
url: "https://www.pulumi.com/dev/examples/aws-cs-s3-folder/"
image: "https://www.pulumi.com/assets/og/dev/examples/aws-cs-s3-folder.png"
---
# Host a Static Website on Amazon S3
A static website hosted on AWS S3
- Source on GitHub: https://github.com/pulumi/examples/tree/master/aws-cs-s3-folder
- Deploy with Pulumi: https://app.pulumi.com/new?template=https%3A%2F%2Fgithub.com%2Fpulumi%2Fexamples%2Ftree%2Fmaster%2Faws-cs-s3-folder
## Get started with this example
This example lives in the [pulumi/examples](https://github.com/pulumi/examples/tree/master/aws-cs-s3-folder) repo. Pull down just this directory to follow along:
```bash
git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
git -C pulumi-examples sparse-checkout set aws-cs-s3-folder
cd pulumi-examples/aws-cs-s3-folder
```
A static website that uses [S3's website support](https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html).
## Deploying and running the program
1. Create a new stack:
```bash
$ pulumi stack init dev
```
1. Set the AWS region:
```
$ pulumi config set aws:region us-west-2
```
1. Run `pulumi up` to preview and deploy changes.
```bash
Previewing update (dev):
Type Name Plan
+ pulumi:pulumi:Stack aws-cs-s3-folder-dev create
+ └─ aws:s3:Bucket my-bucket create
+ ├─ aws:s3:BucketObject index.html create
+ └─ aws:s3:BucketObject favicon.png create
Resources:
+ 4 to create
Do you want to perform this update? yes
Updating (dev):
Type Name Status
+ pulumi:pulumi:Stack aws-cs-s3-folder-dev created
+ └─ aws:s3:Bucket my-bucket created
+ ├─ aws:s3:BucketObject index.html created
+ └─ aws:s3:BucketObject favicon.png created
Outputs:
Endpoint: "http://my-bucket-1234567.s3-website.us-west-2.amazonaws.com"
```
1. Navigate to the website URL:
```bash
$ curl $(pulumi stack output Endpoint)
Hello S3