Remove use of "admin.com" default admin user email #3429

New Issue

OVERLORD · 2026-02-05T06:41:18+03:00

OVERLORD commented

2026-02-05 06:41:18 +03:00

Originally created by @timptner on GitHub (Jan 5, 2023).

Describe the feature you'd like

Instead of using admin.com as default domain better us example.com or example.org. The domain admin.com resolves to a privately owned website whereas example.com and example.org are special domains, which are valid and provided by ICANN for testing purposes.

When a user logs in the first time on a fresh install of BookStack with the default admin credentials and tests the email settings one will successfully send an email but also get a bounce from admin@admin.com. This is bad for the reputation of the email server (either self hosted or third party service).

To solve this issue it's a better solution to use admin@example.com because when sending emails to this address the email will get successfully send and delivered.

Describe the benefits this would bring to existing BookStack users

Testing email delivery on a fresh install will not result in a bounced email.

Can the goal of this request already be achieved via other means?

Changing the default mail address of the admin user to a personal mail address.

This feature request will prevent bounced emails even if a user forgets to change the mail address before testing email settings.

Have you searched for an existing open/closed issue?

I have searched for existing issues and none cover my fundemental request

How long have you been using BookStack?

1 to 5 years

Additional context

No response

Originally created by @timptner on GitHub (Jan 5, 2023). ### Describe the feature you'd like Instead of using `admin.com` as default domain better us `example.com` or `example.org`. The domain `admin.com` resolves to a privately owned website whereas `example.com` and `example.org` are special domains, which are valid and provided by ICANN for testing purposes. When a user logs in the first time on a fresh install of BookStack with the default admin credentials and tests the email settings one will successfully send an email but also get a bounce from `admin@admin.com`. This is bad for the reputation of the email server (either self hosted or third party service). To solve this issue it's a better solution to use `admin@example.com` because when sending emails to this address the email will get successfully send and delivered. ### Describe the benefits this would bring to existing BookStack users Testing email delivery on a fresh install will not result in a bounced email. ### Can the goal of this request already be achieved via other means? Changing the default mail address of the admin user to a personal mail address. This feature request will prevent bounced emails even if a user forgets to change the mail address before testing email settings. ### Have you searched for an existing open/closed issue? - [X] I have searched for existing issues and none cover my fundemental request ### How long have you been using BookStack? 1 to 5 years ### Additional context _No response_

OVERLORD added the 🔨 Feature Request label 2026-02-05 06:41:18 +03:00

OVERLORD closed this issue

2026-02-05 06:41:21 +03:00

OVERLORD commented

2026-02-05 06:41:31 +03:00

@timptner commented on GitHub (Jan 5, 2023):

Issue #602 requests similar change but does not mention the disadvantages of using admin.com.

@timptner commented on GitHub (Jan 5, 2023): Issue #602 requests similar change but does not mention the disadvantages of using `admin.com`.

OVERLORD commented

2026-02-05 06:41:34 +03:00

@ssddanbrown commented on GitHub (Sep 24, 2023):

Thanks for raising @timptner.
I'm going to close this in favour of centralising things in #4575, where a plan is put forward and tracked against for moving away from the existing default credential handling.

@ssddanbrown commented on GitHub (Sep 24, 2023): Thanks for raising @timptner. I'm going to close this in favour of centralising things in #4575, where a plan is put forward and tracked against for moving away from the existing default credential handling.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#3429