--- title: "AWS Serverless Application" description: "Deploy a serverless application on AWS with Pulumi, AWS Lambda, and Amazon API Gateway in TypeScript, Python, Go, C#, YAML, or HCL." url: "https://www.pulumi.com/dev/templates/serverless-application/aws/" image: "https://www.pulumi.com/assets/og/dev/templates/serverless-application/aws.png" --- # AWS Serverless Application Deploy a serverless application on AWS with Pulumi, AWS Lambda, and Amazon API Gateway in TypeScript, Python, Go, C#, YAML, or HCL. The AWS Serverless Application template scaffolds a Pulumi project that deploys a serverless web application to AWS. It provisions an [Amazon S3 bucket](https://www.pulumi.com/registry/packages/aws/api-docs/s3/bucket/) for static website hosting, an [AWS Lambda function](https://www.pulumi.com/registry/packages/aws/api-docs/lambda/function/) for the application backend, and an [Amazon API Gateway REST API](https://www.pulumi.com/registry/packages/aws/api-docs/apigateway/restapi/) that routes requests to the static content and the Lambda function. The template ships with a placeholder web page that displays the current time so the project deploys end to end out of the box. ![An architecture diagram of the AWS Serverless Application template](./architecture.png) ## Using this template To use this template to deploy your own AWS serverless application, make sure you've [installed Pulumi](https://www.pulumi.com/docs/install/) and [configured your AWS credentials](https://www.pulumi.com/registry/packages/aws/installation-configuration#credentials), then create a new [project](https://www.pulumi.com/docs/iac/concepts/projects/) using the template in the language of your choice: **TypeScript** ```bash mkdir my-serverless-app && cd my-serverless-app pulumi new serverless-aws-typescript ``` **Python** ```bash mkdir my-serverless-app && cd my-serverless-app pulumi new serverless-aws-python ``` **Go** ```bash mkdir my-serverless-app && cd my-serverless-app pulumi new serverless-aws-go ``` **C#** ```bash mkdir my-serverless-app && cd my-serverless-app pulumi new serverless-aws-csharp ``` **YAML** ```bash mkdir my-serverless-app && cd my-serverless-app pulumi new serverless-aws-yaml ``` **HCL** ```bash mkdir my-serverless-app && cd my-serverless-app pulumi new serverless-aws-hcl ``` Follow the prompts to complete the new-project wizard. When it's done, you'll have a complete Pulumi project that's ready to deploy and configured with the most common settings. Feel free to inspect the code in `index.ts` for a closer look. ## Deploying the project The template requires no additional configuration. Once the new project is created, you can deploy it with [`pulumi up`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_up): ```bash $ pulumi up ``` When the deployment completes, Pulumi exports the following [stack output](https://www.pulumi.com/docs/iac/concepts/stacks/#outputs) values: **`url`** The HTTP URL for the application. Stack outputs are useful in a number of ways, most commonly as inputs to other stacks or cloud resources. ## Customizing the project **TypeScript / Python / Go / C# / YAML** Projects created with the AWS Serverless template expose the following [configuration](https://www.pulumi.com/docs/iac/concepts/config/) settings: **`path`** The path to the folder containing the files of the website. Defaults to `www`, which is the folder included with the template. The `/date` path is a GET endpoint that retrieves the current time from the Lambda function. **`code`** The path to the folder containing the Lambda function code. Defaults to the `function` folder included with the template. None of these settings is required; by default, the template deploys the website and function using the files in the `www` and `function` folders bundled with the template. **HCL** The HCL version of this template exposes no [configuration](https://www.pulumi.com/docs/iac/concepts/config/) settings. It deploys the website and function using the files in the `www` and `function` folders bundled with the template. ### Using your own web content If you already have a website you'd like to deploy, you can do so by replacing the contents of the `www` folder and redeploying with `pulumi up`. **TypeScript / Python / Go / C# / YAML** Alternatively, you can configure the stack to deploy from another folder on your machine by using [`pulumi config set`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_config_set) to change the value of the website path setting: ```bash $ pulumi config set path ../my-website/dist $ pulumi up ``` ### Customizing the application's functionality You can customize the placeholder website by editing the Lambda function to perform another action, such as displaying a countdown to a future time. You can also add new functionality by creating a new Lambda function, adding a new path to the REST API, and updating the HTML to call the new path. ## Cleaning up You can cleanly destroy the stack and all of its infrastructure with [`pulumi destroy`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_destroy): ```bash $ pulumi destroy ``` ## Learn more - Browse other architecture templates in the [Templates gallery](https://www.pulumi.com/templates). - Explore the [AWS provider API docs](https://www.pulumi.com/registry/packages/aws) in the Pulumi Registry. - Walk through Pulumi from the ground up in [Pulumi Tutorials](https://www.pulumi.com/dev/browse/?type=tutorial). - Read the latest [serverless posts on the Pulumi blog](https://www.pulumi.com/blog/tag/serverless).