Email for the apps you deploy with Coolify.
From your own domain.
Your Coolify server runs the apps. Groundmail sends their email: sign-in codes, password resets, receipts and alerts. Coolify's own deployment and backup alerts can go through the same account.
Set it up on your Coolify server. API key or SMTP, on every plan.
Use the API from your own code, or SMTP for self-hosted apps such as Ghost, n8n, Plausible or WordPress.
- 01Add your API key in CoolifyOpen the application, select Environment Variables and add
GROUNDMAIL_API_KEY. Set Build time to Not available during build, then restart the app. - 02Send from your appOne call from your code. Send a test to your own account email before your domain is verified.
- 03Or give an app the SMTP settingsCreate the password under SMTP in the dashboard. If your server's host blocks port 587, use 2525 with the same settings.
- 04Send Coolify's own alerts tooIn Coolify 4.7 and later: Notifications, Email, Use team email settings, provider SMTP, and StartTLS rather than TLS / SSL.
- 05Verify your sending domainAdd the DKIM, SPF and return-path records we generate. A DMARC starter record is included.
GROUNDMAIL_API_KEY=gm_...import { Groundmail } from "groundmail";
const groundmail = new Groundmail(process.env.GROUNDMAIL_API_KEY!);
await groundmail.emails.send({
from: "Acme <no-reply@mail.acme.com>",
to: "user@example.com",
subject: "Reset your password",
html: "<p>Use this link to reset your password.</p>",
text: "Use this link to reset your password.",
});- host
- smtp.groundmail.dev
- port
- 587 · 2525
- user
- groundmail
- pass
- gmsmtp_••••••••
What you get when your apps send through Groundmail. Without running a mail server next to them.
Authenticated from the first send
Domain setup gives you DKIM, SPF, return-path and a DMARC starter record, so Gmail, Yahoo and Microsoft see an aligned, authenticated sender.
Bounces handled for you
Hard bounces and complaints are suppressed automatically, and signed webhooks tell you when a message was delivered, bounced or complained about.
Kept separate from marketing mail
Transactional mail goes out on its own servers and IPs, so your auth mail never shares a reputation with bulk campaigns.
Support from the people who run it
When a mailbox provider starts deferring, the people investigating are the ones who operate the servers.
Groundmail vs running your own mail server. On the same box as your apps.
| Topic | Your own SMTP server | Groundmail |
|---|---|---|
| Cost | Server costs plus the time to run it | $03,000 emails/mo free; then $15/mo for 20,000 |
| Servers and IPs | You run, patch and monitor them; a new IP starts with no reputation | Run, patched and monitored by our team; IPs already warmed |
| Authentication | You set up DKIM signing, SPF and DMARC yourself | DKIM, SPF, return-path and a DMARC starter record generated for you |
| Bounces | You parse bounce messages and keep your own suppression list | Hard bounces and complaints suppressed automatically, reported by signed webhooks |
Running your own server can make sense at very high volume with a team to operate it. Many cloud hosts block outbound port 25 by default.
Questions
Does it work with self-hosted apps such as Ghost and n8n?
Yes, with any app that takes SMTP settings. Put the host, port, username and password in the app's environment variables in Coolify and restart it.
My server's host blocks SMTP ports. What then?
Use port 2525 with the same settings, or send from your app over HTTPS with the API key. Neither needs a request to your host.
Can Coolify's own notifications go through Groundmail?
Yes. Deployment, backup, scheduled task and server alerts send through the SMTP relay. In Coolify 4.7 and later, open Notifications, select Email, choose Use team email settings and SMTP, and enter the same host, port, username and password with StartTLS.
Do I need a card to start?
No. The Free plan sends 3,000 emails a month with no card. Add one when you want more volume.
What happens when I go past the free plan?
Pay as you go is $15 a month with 20,000 emails included, then a per-email rate after that. You only move up when you add a card.
Give your Coolify apps
a way to send email.
Create an account, add your key or SMTP credential in Coolify and send a test in a few minutes.