Getting started
Deadlift is distributed as a CloudFormation template through AWS Marketplace. You subscribe through the AWS Marketplace listing, choose a region, and the template deploys the dashboard, Lambdas, DynamoDB tables, and IAM roles into your own AWS account.
This page describes the install path you’ll follow once the listing is live.
Prerequisites
You need:
- An AWS account where you have permission to create CloudFormation stacks
- A region of your choice (Deadlift supports any region SQS, Lambda, AppSync, and Cognito are available in)
- An email address for CloudWatch alarm notifications (optional but recommended)
Subscribing
- Visit the Deadlift listing on AWS Marketplace (link will be added once approved).
- Click Subscribe and accept the EULA.
- Choose your tier (Free, Solo, Team, or Enterprise).
- Click Continue to Configuration.
Deploying the stack
The Marketplace flow hands you off to CloudFormation with the Deadlift template preloaded. You’ll see the following parameters:
| Parameter | Description | Default |
|---|---|---|
| Subscription tier | Set automatically by Marketplace based on your subscription. Don’t change this unless instructed. | Set by Marketplace |
| Notification email address | Email to receive DLQ threshold alerts. Leave blank to disable email notifications. | empty |
| DLQ message count alert threshold | Alert when any monitored DLQ exceeds this message count. | 10 |
Click Create stack and wait 5-10 minutes. CloudFormation will create:
- A CloudFront distribution for the dashboard UI
- A Cognito user pool for authentication
- An AppSync GraphQL API
- 13 Lambda functions and an AppSync JS resolver
- 5 DynamoDB tables for sessions, audit log, counters, auto-replay rules, and settings
- An SNS topic for alerts (only subscribes the email address if you provided one)
First login
When the stack finishes, the Outputs tab shows a DashboardUrl value -
that’s your CloudFront URL.
- Open the URL.
- The Cognito hosted UI will prompt you to set a password (the AWS Marketplace flow creates an initial admin user with your AWS account email).
- After login you’ll see your DLQs listed in the dashboard.
That’s it. No agents to install, no servers to provision, no data plane outside your AWS account.
Updating
When a new version of Deadlift is released, the dashboard will show an “update available” banner. Updating is a single CloudFormation stack update - the marketplace listing always points at the latest stable template.
Where next
- Architecture overview - what gets deployed and why
- Security model - data residency, IAM, and access control
- FAQ - common questions