@astro-aws/adapter

An Astro adapter for building an SSR application and deploying it to AWS Lambda.

Compatibility

Requires Astro 6+ and Node.js 22+.

Install

# Using NPM
npx astro add @astro-aws/adapter

# Using Yarn
yarn astro add @astro-aws/adapter

# Using PNPM
pnpm astro add @astro-aws/adapter

# Using Bun
bun x astro add @astro-aws/adapter

Manually

1. Install the package.

# Using NPM
npm install -D @astro-aws/adapter

# Using Yarn
yarn add -D @astro-aws/adapter

# Using PNPM
pnpm add -D @astro-aws/adapter

# Using Bun
bun add -D @astro-aws/adapter

2. Add the following to your astro.config.mjs file.

import { defineConfig } from "astro/config"
import astroAws from "@astro-aws/adapter"

export default defineConfig({
    output: "server",
    adapter: astroAws(),
})

SSR Usage

1. Install the package.

# Using NPM
npm install -D @astro-aws/adapter

# Using Yarn
yarn add -D @astro-aws/adapter

# Using PNPM
pnpm add -D @astro-aws/adapter

# Using Bun
bun add -D @astro-aws/adapter

2. Add the following to your astro.config.mjs file.

import { defineConfig } from "astro/config"
import astroAws from "@astro-aws/adapter"

export default defineConfig({
    output: "server",
    adapter: astroAws({
        mode: "ssr",
    }),
})

SSR Stream Usage

1. Install the package.

# Using NPM
npm install -D @astro-aws/adapter

# Using Yarn
yarn add -D @astro-aws/adapter

# Using PNPM
pnpm add -D @astro-aws/adapter

# Using Bun
bun add -D @astro-aws/adapter

2. Add the following to your astro.config.mjs file.

import { defineConfig } from "astro/config"
import astroAws from "@astro-aws/adapter"

export default defineConfig({
    output: "server",
    adapter: astroAws({
        mode: "ssr-stream",
    }),
})

Edge Usage

1. Install the package.

# Using NPM
npm install -D @astro-aws/adapter

# Using Yarn
yarn add -D @astro-aws/adapter

# Using PNPM
pnpm add -D @astro-aws/adapter

# Using Bun
bun add -D @astro-aws/adapter

2. Add the following to your astro.config.mjs file.

import { defineConfig } from "astro/config"
import astroAws from "@astro-aws/adapter"

export default defineConfig({
    output: "server",
    adapter: astroAws({
        mode: "edge",
    }),
})

Limitations

• Environment variables are not supported
• Limited execution time (5 seconds for viewer request/response, 30 seconds for origin request/response)
• Smaller deployment package size limits
• Limited access to AWS services (no VPC access)
• No access to the file system (except /tmp)

Example

See the source code of this site