Skip to content
Groundmail

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.

3,000 emails a month free, then $15 a month for 20,000. No card to sign up.

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.

  1. 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.
  2. 02Send from your appOne call from your code. Send a test to your own account email before your domain is verified.
  3. 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.
  4. 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.
  5. 05Verify your sending domainAdd the DKIM, SPF and return-path records we generate. A DMARC starter record is included.
Environment Variables
GROUNDMAIL_API_KEY=gm_...
send-email.ts
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.",
});

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.

TopicYour own SMTP serverGroundmail
CostServer costs plus the time to run it$03,000 emails/mo free; then $15/mo for 20,000
Servers and IPsYou run, patch and monitor them; a new IP starts with no reputationRun, patched and monitored by our team; IPs already warmed
AuthenticationYou set up DKIM signing, SPF and DMARC yourselfDKIM, SPF, return-path and a DMARC starter record generated for you
BouncesYou parse bounce messages and keep your own suppression listHard 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.