TestDriver AWS Self-Hosted Setup
Deploys TestDriver test infrastructure on your own AWS account via CloudFormation, with a Vitest hook that spawns and terminates EC2 instances per test.
AutomationAdvanced★ 239⑂ 35AI score 7/10Last updated: Aug 16, 2026
What it does
- Walks through deploying a CloudFormation stack that creates a dedicated VPC, public subnet, security group, IAM roles/instance profile and an EC2 launch template.
- Shows how to add
testdriverai/vitest/setup-awstosetupFilesso each test automatically gets a fresh EC2 instance that is terminated afterwards. - Provides local run commands, a complete GitHub Actions workflow, the required repository secrets table, and an OIDC alternative to long-lived keys.
- Covers Golden Image AMI customization (RDP in, rotate password, install software, bake a new AMI) plus a troubleshooting checklist.
Who it's for
- QA and platform engineers who need Windows desktop/browser E2E tests running inside their own AWS account.
- Teams already using TestDriver with Vitest that want to move off cloud-hosted runners.
- DevOps engineers wanting clean, auto-terminated Windows runners for every CI job.
Example uses
- "Deploy the TestDriver stack in us-east-2 and give me the LaunchTemplateId" → produces the
aws cloudformation deploycommand plus the Outputs query. - "Wire the self-hosted hook into my Vitest config and run one test locally" → updates
setupFilesand runsTD_OS=windows AWS_REGION=... vitest run. - "Create a GitHub Actions workflow that runs self-hosted Windows tests on every PR" → generates the YAML and the list of secrets to add.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/testdriverai/testdriverai/HEAD/ai/skills/testdriver-aws-setup/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the ai/skills/testdriver-aws-setup folder from the GitHub repo testdriverai/testdriverai into my ~/.claude/skills/testdriver-aws-setup/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/testdriverai/testdriverai.git && mkdir -p ~/.claude/skills && cp -r testdriverai/ai/skills/testdriver-aws-setup ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/testdriverai/testdriverai.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r testdriverai/ai/skills/testdriver-aws-setup ~/.claude/skills/ - Restart Claude Code and confirm
testdriver:aws-setupappears in your skill list. - Prerequisites: an AWS account with CloudFormation permissions, AWS CLI configured via
aws configure, Node.js 20+, a Vitest project, and TestDriver-granted access to their AMI in your region. - Ask Claude to "set up self-hosted TestDriver infrastructure on AWS". Because the steps create billable EC2 resources, review every command before approving it.