Files
vaultwarden/Disable-registration-of-new-users.md
Stefan Melmuk 30a969e9b3 update domain
2025-08-11 22:57:42 +02:00

33 lines
2.1 KiB
Markdown

By default, anyone who can access your instance can register for a new account. To disable this, set the `SIGNUPS_ALLOWED` env variable to `false`:
```bash
docker run -d --name bitwarden \
-e SIGNUPS_ALLOWED=false \
-v /vw-data/:/data/ \
-p 80:80 \
vaultwarden/server:latest
```
## Disabling organization invitations
Even when `SIGNUPS_ALLOWED=false`, an existing user who is an organization owner or admin can still invite new users. If you want to disable this as well, see [[Disable invitations|disable-invitations]].
## Restricting registrations to certain email domains
You can restrict registration to email addresses from certain domains by setting `SIGNUPS_DOMAINS_WHITELIST` accordingly. For example:
* `SIGNUPS_DOMAINS_WHITELIST=example.com` (single domain)
* `SIGNUPS_DOMAINS_WHITELIST=example.com,example.net,example.org` (multiple domains)
> [!WARNING]
> If `SIGNUPS_DOMAINS_WHITELIST` is set, then the value of `SIGNUPS_ALLOWED` is ignored.
You may also want to set `SIGNUPS_VERIFY=true`, which would require email verification before a newly-registered user can successfully log in. This would prevent someone from registering with a fake email address that has the proper domain.
## Visibility of the Create account link
When `SIGNUPS_ALLOWED=false` (and the `SIGNUPS_DOMAINS_WHITELIST` is empty) the `Create account` link will be hidden in the web vault UI unless you have not [configured email](https://github.com/dani-garcia/vaultwarden/wiki/SMTP-Configuration) and allow invitations (cf. [#6109](https://github.com/dani-garcia/vaultwarden/issues/6109)). If you don't want to have the link visible even in the latter case you can hide the link by using [Custom CSS](https://github.com/dani-garcia/vaultwarden/wiki/Customize-Vaultwarden-CSS).
## Invitations via the admin page
The vaultwarden admin can invite anyone via the [[admin page|Enabling-admin-page]], regardless of any of the restrictions above. If mail has been disabled and the link is not visible, invited users can still visit `https://vaultwarden.example.tld/#/signup` and use the email address that was invited to register their account.