testdriveraws-setuplisted
Install: claude install-skill testdriverai/testdriverai
<!-- Generated from aws-setup.mdx. DO NOT EDIT. -->
This guide walks you through setting up self-hosted TestDriver instances on AWS. By the end, you'll have fully automated test infrastructure that spawns and terminates instances on-demand.
```mermaid
graph LR
A[Vitest Test] --> B[setup-aws hook]
B --> C[Spawns EC2]
C --> D[Runs Test]
D --> E[Terminates EC2]
```
## How It Works
TestDriver automatically manages AWS EC2 instances for your tests:
1. **Deploy CloudFormation** — One-time infrastructure setup
2. **Configure Vitest** — Add one line to your config
3. **Run Tests** — Instances spawn automatically, run tests, and terminate
That's it! No manual instance management needed.
# Quickstart
<Steps>
<Step title="Deploy Infrastructure">
<Card
title="Launch CloudFormation Stack"
icon="aws"
href="https://console.aws.amazon.com/cloudformation/home#/stacks/create/review?templateURL=https://v7-cloudformation-template.s3.us-east-2.amazonaws.com/cloudformation.yaml"
horizontal
arrow
>
One-click AWS setup
</Card>
</Step>
<Step title="Add to Vitest Config">
```javascript vitest.config.mjs
setupFiles: ['testdriverai/vitest/setup', 'testdriverai/vitest/setup-aws']
```
</Step>
<Step title="Run Tests">
```bash
TD_OS=windows AWS_REGION=us-east-2 \
AWS_LAUNCH_TEMPLATE_ID=lt-xxx AMI_ID=ami-xxx \
vitest run
```
</Step>
</Steps>
## Overview
The setup process is sim