testdriveraws-setuplisted
Install: claude install-skill testdriverai/testdriverai
<!-- Generated from aws-setup.mdx. DO NOT EDIT. -->
This guide helps you to set up self-hosted TestDriver instances on AWS. At the end, you have automated test infrastructure. It starts and stops instances when you need them.
```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 manages the AWS EC2 instances for your tests automatically:
1. **Deploy CloudFormation**. Set up the infrastructure one time.
2. **Configure Vitest**. Add one line to your config.
3. **Run Tests**. The instances start automatically, run the tests, and stop.
That is all. You do not need to manage the instances by hand.
# 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 proc