Wraps Logo
DocsHome
Complete Guide

Complete AWS Setup Guide

New to AWS? This guide walks you through everything from account creation to deploying your first email infrastructure.

10-15 min

What is AWS?

Amazon Web Services (AWS) is Amazon's cloud computing platform. When you use Wraps, we deploy email infrastructure to your AWS account. This means:

  • You own everything — Infrastructure runs in your account
  • Transparent pricing — Pay AWS directly at $0.10/1,000 emails
  • No vendor lock-in — Infrastructure stays even if you stop using Wraps

AWS Free Tier

New AWS accounts get 3,000 outbound SES emails per month free for 12 months.

1
Create an AWS Account

If you don't have an AWS account yet, you'll need to create one.

What You'll Need
  • Email address
  • Phone number for verification
  • Credit or debit card (for verification, free tier available)
Create AWS Account

Account activation takes a few minutes

AWS may take up to 24 hours to fully activate your account, but most are ready within minutes.

2
Install AWS CLI

The AWS Command Line Interface (CLI) lets you interact with AWS from your terminal.

brew install awscli

macOS: Requires Homebrew. Or download directly from AWS.

Verify Installation

After installing, verify the CLI is working:

GNU Bashterminal.sh
aws --version

You should see something like aws-cli/2.x.x Python/3.x.x ...

3
Create IAM User with Access Keys

IAM (Identity and Access Management) lets you create users with specific permissions. You'll create a user that the CLI can use.

What are Access Keys?
Access Keys are like a username/password for programmatic access. They consist of:
  • Access Key ID — Like a username (starts with AKIA...)
  • Secret Access Key — Like a password (keep this secret!)

Step-by-Step:

  1. Open IAM Console
    https://console.aws.amazon.com/iam/home#/users
  2. Create User
    Click "Create user" → Name it wraps-cli → Click "Next"
  3. Set Permissions
    Select "Attach policies directly" → Search for AdministratorAccess → Check the box → Click "Next" → "Create user"
  4. Create Access Key
    Click on your new user → "Security credentials" tab → "Create access key" → Select "Command Line Interface (CLI)" → Click through the confirmation
  5. Save Your Keys
    Copy your Access Key ID and Secret Access Key. You'll need these in the next step.

Keep your Secret Access Key safe!

AWS only shows the secret key once. Store it securely (password manager) and never share it.

4
Configure AWS CLI

Now configure the AWS CLI with your access keys:

GNU Bashterminal.sh
aws configure

When prompted, enter your values:

Output
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLEAWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEYDefault region name [None]: us-east-1Default output format [None]: json
Region Selection

Choose a region close to your users. Common choices:

  • us-east-1 — US East (Virginia)
  • eu-west-1 — Europe (Ireland)
  • ap-southeast-1 — Asia (Singapore)

5
Verify Your Setup

Test that your credentials are working:

GNU Bashterminal.sh
aws sts get-caller-identity

You should see your Account ID, User ID, and ARN. If you get an error, check the troubleshooting guide.

6
Deploy Wraps

Now you're ready to deploy email infrastructure:

GNU Bashterminal.sh
npx @wraps.dev/cli email init

The wizard will guide you through selecting your hosting provider, region, and configuration.

Complete Checklist

  • AWS account created and activated
  • AWS CLI installed
  • IAM user created with access keys
  • AWS CLI configured (aws configure)
  • Verified with aws sts get-caller-identity
  • Deployed with npx @wraps.dev/cli email init

Next Steps

Verify Your Domain

Set up DKIM, SPF, and DMARC for better deliverability.

Domain Setup
Production Access

Move out of sandbox mode to send to any recipient.

Get Production Access