> ## Documentation Index
> Fetch the complete documentation index at: https://openemail-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# What you're installing

> The pieces of an OpenEmail install, who owns each one, and what setup asks of you.

> [!NOTE]
>
> OpenEmail is in early access, so talk to us to install it.

From no install to an agent that can run your store's email:

* **Outcome:** your own copy of OpenEmail, in accounts you own, installed in your Shopify admin, connected to your agent, with a sending domain that passes its check.
* **Time:** one session with your agent, plus waits nobody can speed up: PostShiba's approval, your DNS changes and the first pull of your Shopify data.
* **You'll touch:**
  * Your Shopify admin (install the app, then **Allow** your agent)
  * PostShiba (sign up, request approval, copy one key)
  * Render (sign up, add a card, authorize your agent's login)
  * Your DNS host, twice
  * Your coding agent on a Mac, which runs every command

Your copy serves one store. Nothing is shared with other merchants, and no part of it runs in our accounts.

## What runs, and where

* **Render** hosts your copy as three pieces:
  * A **web service** at your own hostname, such as `email.yourstore.com`. It serves the app inside your Shopify admin, the address your agent connects to, and the unsubscribe and tracked links in your emails.
  * A **worker** that does the background work: pulling in Shopify customers and orders, handing messages to your sender, and checking your sending domain.
  * A **database** (PostgreSQL) holding your contacts, consent, do-not-email list, emails, flows and the record of who did what.
* **PostShiba** delivers your mail and signs it with your sending domain. OpenEmail hands each message to PostShiba; PostShiba sends it.
* **Shopify** holds the app, created in your store's own organization. Your customers and orders come from Shopify, and every approval happens in your Shopify admin.
* **Your domain** gets two names: the hostname for your copy (`email.yourstore.com`) and a sending domain (`news.yourstore.com` by default).

## What you own

* **Every account:** the Shopify app, the Render account, the PostShiba team and the domain. You pay each bill directly.
* **Your data:** it sits in a database in your Render account. You can export it and move your copy elsewhere.
* **The decisions:** your agent asks before it installs anything on your Mac, before anything that costs money, and before every deploy. Campaigns going out, flows going live and a Klaviyo migration wait for a person to approve them in the Shopify admin.

## What setup doesn't need

* A GitHub account.
* A developer on call. Your agent runs every command and asks you only for what a person has to do: create an account, add a card, sign in, click **Install** or **Allow**, edit DNS.
* An administrator password for the tools your agent installs. Git is the exception: it comes from Apple's own installer, which may ask for one.

Next, [gather what you need before you start](https://openemail-docs.mintlify.site/setup/before-you-start.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.