Prerequisites

• A Github account
• An AWS account

If you have any questions join #self-host on discord.

Step 1: Environment variables

Unsend depends on AWS ses to send emails and SNS to receive email status. Along with that it also depends on Postgres as a database and Redis for queue. Copy the .env.selfhost.example file to .env and fill in the values.

AWS credentials

tl;dr: Login to your AWS console and create a new user with programmatic access. Attach the AmazonSNSFullAccess and AmazonSESFullAccess policies to the user. Then create a new access key for the user.

Add the following environment variables.

```env
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
```

Follow this for detailed steps: Create AWS credentials

Github app credentials for login

Usend uses github authentication for login.

Use this link to create an github app

Callback URL : https:///api/auth/callback/github

Add the following environment variables.

GITHUB_ID=""
GITHUB_SECRET=""

Next auth url and secret

Url is the app url you're going to use/

Add the following environment variables.

  NEXTAUTH_SECRET=""

Step 3: Setting up a region

In order to send emails, you need to select an region in aws. Use a region where your users are located / where unsend is hosted. If you're confused just use us-east-1.

You can check available regions here

Once you logged in to unsend, it will prompt you add ses configuration