Skip to content

docs(web/guides): add Groundmail to the SMTP providers table #4635

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bpamiri merged 3 commits into from
Oct 23, 2026
Merged

docs(web/guides): add Groundmail to the SMTP providers table #4635

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
03454d4
docs(web/guides): add Groundmail to the SMTP providers table
Ktryberceo Oct 23, 2026
6ee491b
docs(web/guides): apply review edits to the Groundmail row
bpamiri Oct 23, 2026
1fe93fc
ci(web): skip Cloudflare publish for fork PRs, like Dependabot
bpamiri Oct 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion .github/workflows/web-deploy.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,9 @@ jobs:
# Dependabot: the Build step above still runs and validates the bump;
# we just don't push a per-PR preview deploy for it. Non-PR events
# (push to develop, repository_dispatch) keep deploying as before.
if: github.actor != 'dependabot[bot]'
if: |
github.actor != 'dependabot[bot]'
&& (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository)
working-directory: web
env:
CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
Expand Down
7 changes: 6 additions & 1 deletion web/sites/guides/src/content/docs/v4-2-0/digging-deeper/sending-email.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -295,17 +295,22 @@ Use a `.html` or `.txt` extension and open the file in a browser or editor. To p

## Third-party services

Postmark, SendGrid, AWS SES, Mailgun — they all expose an SMTP endpoint. The mailer code above doesn't change per-provider; only the `server`, `port`, `username`, `password` defaults do.
Postmark, SendGrid, AWS SES, Mailgun, Groundmail — they all expose an SMTP endpoint. The mailer code above doesn't change per-provider; only the `server`, `port`, `username`, `password` defaults do.

| Provider | Server | Port | Username | Password |
|----------|--------|------|----------|----------|
| **Postmark** | `smtp.postmarkapp.com` | 587 | your server token | your server token |
| **SendGrid** | `smtp.sendgrid.net` | 587 | `apikey` (literal) | your API key |
| **AWS SES** | `email-smtp.<region>.amazonaws.com` | 587 | SES SMTP username | SES SMTP password |
| **Mailgun** | `smtp.mailgun.org` | 587 | `postmaster@<domain>` | Mailgun SMTP password |
| **Groundmail** | `smtp.groundmail.dev` | 587 (or 2525) | `groundmail` (literal) | an SMTP credential (`gmsmtp_…`) |

*Disclosure: the Groundmail row was contributed by the Groundmail team.*

Each provider has its own sender-verification and domain-setup flow (SPF, DKIM, DMARC). Follow their docs for that — the framework side is just SMTP.

Groundmail's sandbox sends only from `noreply@mail.groundmail.dev` to your own account email until you verify a sending domain and add a payment method; other recipients get a 403. See [Groundmail's SMTP docs](https://docs.groundmail.dev/smtp).

## Related guides

<CardGrid>
Expand Down
Loading