LaunchFast Logo LaunchFast

Deploy Astro to AWS Elasic Beanstalk: A Step-by-Step Guide

Rishi Raj Jain
Deploy Astro to AWS Elasic Beanstalk

In this guide, you will learn how to deploy an Astro SSR project to AWS Elasic Beanstalk. You will go through the process of setting up a new Astro project, enabling server-side rendering, and finally deploying it to AWS Elasic Beanstalk.

Table Of Contents


You’ll need the following:

Create a new Astro application

Let’s get started by creating a new Astro project. Open your terminal and run the following command:

npm create astro@latest my-app

npm create astro is the recommended way to scaffold an Astro project quickly.

When prompted, choose:

  • Empty when prompted on how to start the new project.
  • Yes when prompted if plan to write Typescript.
  • Strict when prompted how strict Typescript should be.
  • Yes when prompted to install dependencies.
  • Yes when prompted to initialize a git repository.

Once that’s done, you can move into the project directory and start the app:

cd my-app
npm run dev

The app should be running on localhost:4321. Next, execute the command below to install the necessary libraries and packages for building the application:

npm install dotenv
npm install -D prepend-file

The libraries installed include:

  • dotenv: A library for handling environment variables.

The development-specific libraries include:

  • prepend-file: A library to prepend data to a file.

Getting Started with the Node.js Adapter for Astro

Before deploying your Astro project, you need to install the @astrojs/node adapter. Execute the following command:

npm install @astrojs/node

The libraries installed include:

  • @astrojs/node: An adapter that prepares Astro websites to be ran as Node.js server.

Once the adapter is installed, you’ll need to add it to your astro.config.mjs file. Open the file and add the following code:

// File: astro.config.mjs

import node from '@astrojs/node'; 
import { defineConfig } from 'astro/config';

export default defineConfig({
  output: "server", 
  adapter: node({ 
    mode: "standalone"

The additions do the following:

  • Imports default export of @astrojs/node.
  • Uses the above import as the adapter of your Astro application.
  • Sets output to server to enable server-side rendering compatible output.

Then, create a zip.mjs at the root of repository with the following code:

// File: zip.mjs

import zl from "zip-lib"
import { join } from "node:path"
import { sync as prependSync } from "prepend-file"

const zip = new zl.Zip()

prependSync(join("dist", "server", "entry.mjs"), `import 'dotenv/config'\n`)

zip.addFolder("./dist", "dist")
zip.addFile("./package.json", "package.json")
zip.addFile("./tsconfig.json", "tsconfig.json")
zip.addFolder("./node_modules", "node_modules")



The code above does the following:

  • Imports dotenv/config in dist/server/entry.mjs to load all the environment variables into the scope, making them accessible via process.env object.
  • Creates a zip with the following files and folders in it:
    • dist: containing the static and server side required assets.
    • node_modules: collection of installed dependencies.
    • tsconfig.json: containing path aliases.
    • package.json: used by AWS Elastic Beanstalk to run the npm run start command.

Now, execute the following command to generate a zip file containing static assets, server-side bundle and package.json:

npm run build && node zip.mjs

Once it completes, you’d see a zip file with the name beginning with deployment_. You’ll use this zip to deploy your application on AWS Elastic Beanstalk. Let’s get started with the configuring the IAM roles required to deploy an application to AWS Elastic Beanstalk.

Configure your IAM Roles

Grab Deployment URL in AWS Amplify
  • Select AWS Service and choose Elastic Beanstalk as the Service or use case.
Grab Deployment URL in AWS Amplify
  • Go by the default permissions set, and click Next.
Grab Deployment URL in AWS Amplify
  • Enter aws-elasticbeanstalk-ec2-role as the Role name.
Grab Deployment URL in AWS Amplify
  • Go back to the IAM Console, and click Create role.
Grab Deployment URL in AWS Amplify
  • Select AWS Service and choose EC2 as the Service or use case.
Grab Deployment URL in AWS Amplify
  • Filter the large set of permissions policies, type AWSElasticBeanstalk, select the following:

    • AWSElasticBeanstalkMulticontainerDocker
    • AWSElasticBeanstalkWebTier
    • AWSElasticBeanstalkWorkerTier

Then, click Next.

Grab Deployment URL in AWS Amplify
  • Enter ec2-roles as the Role name.
Grab Deployment URL in AWS Amplify

and you are now done with setting up IAM Roles for your account. Let’s move on to deploy your Astro application to AWS Elastic Beanstalk.

Deploy to AWS Elastic Beanstalk

The code is now ready to deploy to AWS Elasic Beanstalk. Use the following steps to deploy:

  • Start by creating a GitHub repository containing your app’s code.

  • Then, navigate to the AWS Elasic Beanstalk Dashboard and click on Create application under Get Started under section.

AWS Elastic Beanstalk
  • Give the application a name of your choice.
Configure AWS Elastic Beanstalk application
  • Select Node.js as the platform you are going to use, and click Next.
Select platform in AWS Elastic Beanstalk
  • Select Use an existing service role to use the aws-elasticbeanstalk-ec2-role and ec2-roles you created earlier, and click Next.
Select service role in AWS Elastic Beanstalk
  • Select the default VPC, then enable public IP address and check all the subnets.
Select VPC in AWS Elastic Beanstalk
  • Scroll down to the EC2 Security Groups section and use the default one.
Select Security Group in AWS Elastic Beanstalk
  • Scroll down to the Environment properties section, and add a key value pair to be used as an environment variable.
Environment Variables in AWS Elastic Beanstalk
  • Say the environment variable to be accessed as process.env.SERVER_VARIABLE is SERVER_VARIABLE and it’s value is TEST.
Add Environment Variables in AWS Elastic Beanstalk
  • Wait for the application to go live, and then click Upload and Deploy button at the top right corner.
Working AWS Elastic Beanstalk Application
  • Click Choose file, select the zip file you created earlier, and click Deploy.
Upload the zip in AWS Elastic Beanstalk
  • Wait for the application to report it’s Health as Ok. Once all’s good, click the URL below Domain to see your Astro application in action.
Open the Assigned Domain in AWS Elastic Beanstalk


Yay! You’ve now an Astro project that deploys to AWS Elasic Beanstalk.

If you have any questions or comments, feel free to reach out to me on Twitter.

Learn More Using PhotoSwipe in Astro to Build an Image Gallery → Using Transformers for Shiki to enrich Syntax Highlighting in Astro → Using GreenSock Animation Platform (GSAP) in Astro with View Transitions: A Step-by-Step Guide →