AWS Static Website

Pulumi Official
Package maintained by Pulumi
v0.0.4 published on Tuesday, Jun 7, 2022 by Pulumi

This component makes it easy to deploy a static website to Amazon S3 along with an optional CloudFront distribution using any of the supported Pulumi programming languages, including markup languages like YAML and JSON.


import * as staticwebsite from "@pulumi/aws-static-website"

const site = new staticwebsite.Website("website", {
    sitePath: "../website/build"

export const url = site.websiteURL;
import (
	website ""

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {

		website, err := website.NewWebsite(ctx, "website", &website.WebsiteArgs{
			SitePath: pulumi.String("../website/build"),
		if err != nil {
			return err

		ctx.Export("websiteURL", website.WebsiteURL)
		return nil
import pulumi
from pulumi_aws_static_website import Website

web = Website('website',

pulumi.export('websiteURL',  web.websiteURL)
    type: "aws-static-website:index:Website"
      sitePath: "../website/build"
  websiteURL: ${web.websiteURL}

Input Properties

This component takes the following inputs.

  • sitePath - the root directory containing the website’s contents to be served (required)
  • withCDN - provision a CloudFront CDN to serve content
  • targetDomain - the domain used to serve the content. A Route53 hosted zone must exist for this domain if this option is specified
  • index.html - the default document for the site. Defaults to index.html
  • error404 - the default 404 error page
  • certificateARN - the ARN of the ACM certificate to use for serving HTTPS. If one is not provided, a certificate will be created during the provisioning process
  • cacheTTL - TTL in seconds for cached objects. Defaults to 600 (i.e. 10 minutes) if not specified
  • withLogs - provision a bucket to house access logs
  • priceClass - the price class to use for the CDN. Defaults to 100 if not specified


This component provides the following outputs. Some may not be available depending on the given input configuration (e.g. if withCDN was not specified there will be no output for cdnDomainName and cdnURL)

  • bucketName - the name of the S3 bucket containing the website’s contents
  • bucketWebsiteURL - the website URL for the S3 bucket
  • cdnDomainName - the CDN domain name
  • cdnURL - the CDN’s endpoint URL
  • logsBucketName - the name of the S3 bucket containing the access logs
  • websiteURL - the URL to access the website


  • If specifying a target domain and provisioning a CloudFront distribution, it is assumed there is a hosted zone configured in Route53 for that target domain.
  • If you already have an ACM certificate provisioned for your domain, then you can simply pass the ARN as one of the input properties. If not we will attempt to provision one for you based on the target domain provided.