Skip to content

Revise email setup and test account instructions in staging #5977

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
hardillb merged 1 commit into from
Oct 22, 2026
Merged

Revise email setup and test account instructions in staging #5977

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
8 changes: 2 additions & 6 deletions nuxt/content/handbook/engineering/ops/staging.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ and assign to the CTO for review.

## Email

Amazon SES is setup on staging however it is still running in sandbox mode which means only verified address & domains can RECEIVE emails from it, this is currently limited to flowfuse.com email addresses and a small set of pre-approved disposable emails.
Amazon SES is setup on staging however it is still running in sandbox mode which means only verified address & domains can RECEIVE emails from it, this is currently limited to `flowfuse.com` and `flowfuse.dev` email addresses.

If you need to use another email address with staging then you should raise an issue
in [CloudProject](https://github.com/FlowFuse/CloudProject) and assign to the CTO for review.
Expand All @@ -32,11 +32,7 @@ If approved, the email will need to be added to the SES configuration in the AWS

### Test Email accounts

We have enabled a small list of mailinator.com based email addresses for the purposes
of short-lived testing of sign-up and user management.

The inboxes for these email addresses are publicly accessible if known, so the list
is available on [this private issue](https://github.com/FlowFuse/CloudProject/issues/135).
As the `flowfuse.com` email domain is configured to use SSO, it cannot be used to create test accounts in the Staging environment. Instead, use `<user>@flowfuse.dev`; we have an email forwarder in place so email sent to `foo@flowfuse.dev` will get relayed to `foo@flowfuse.com`. This also works with `foo+test@flowfuse.dev` type addresses. This means you can setup multiple test accounts under your own email. It also means we have visibility on who owns particular test accounts in the staging environment.

### Accessing Staging

Expand Down
Loading