Make yourself at home.
Your guide to a workspace of your own. Set up postnuva, connect your domain, and get your first mailbox ready for the conversations ahead.
Find your next step
Set up your workspace
Create your account and get your first mailbox ready.
Configure DNS
Connect your domain and verify your mail records.
Connect a mail client
Use Apple Mail, Thunderbird, or your phone.
Send from your application
Use an API key and a single HTTP request.
Quick start
From a fresh install to your first working mailbox, the path is the same for everyone.
- Create your account
Register, then verify your email address to activate your workspace.
- Add your domain
Add a domain you own in the dashboard. postnuva generates the exact DNS records to publish.
- Configure DNS
Publish the generated records at your DNS provider and run verification. See the DNS setup guide.
- Create mailboxes
Once the domain verifies, create mailboxes like
[email protected]and set their passwords.
postnuva does not sell domains. Bring a domain you already own and keep access to its DNS provider to publish records.
Connect your mail
Reach your mailboxes three ways: the web app in your browser, any standard mail client, or your own backend through the API.
Mail clients (SMTP, IMAP, POP3)
Use your full email address as the username and your mailbox password. Replace the hostnames with your own deployment’s hostnames.
| Purpose | Protocol | Host | Port | Encryption |
|---|---|---|---|---|
| Sending | SMTP (submission) | smtp.example.com | 587 | STARTTLS |
| Sending | SMTP over TLS | smtp.example.com | 465 | SSL/TLS |
| Receiving | IMAP | imap.example.com | 993 | SSL/TLS |
| Receiving | POP3 | pop.example.com | 995 | SSL/TLS |
IMAP keeps mail synced across devices; POP3 downloads it to one device. Most people want IMAP.
Send with the API
Generate a send-enabled API key in the dashboard, then send from an owned mailbox on a verified domain. Pass the key in the X-Api-Key header.
curl -X POST 'https://postnuva.com/api/emails/send-api' \
-H "X-Api-Key: $POSTNUVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "A little hello.",
"text": "Sent from my own corner of the internet."
}'Treat keys like passwords. Store them as environment variables on your server and never commit them or expose them in client-side code.
Self-hosting
postnuva runs on your own infrastructure, built on a proven mail stack: SMTP services for send and receive, Dovecot for IMAP and POP3, and PostgreSQL with Maildir storage.
- Deploy with Docker. Bring the stack to your own server and manage it your way.
- Your data stays yours. Mail and metadata live on your server, in your database and Maildir.
- Tune it to your needs. Configure services, limits, and policies to match how you run things.