This repository helps to host your own Vaultwarden instance on your server or a raspberry-pi.

Edit your settings in the .env file.

Start the containers with

docker-compose up -d

⚠️ You have to install Traefik as well.

In the docker-compose.yml file the admin-token is disabled. If this setting is disabled you are not able to open the admin page (yourhost.local/admin).

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.

More information

You can restrict registration to email addresses from certain domains by setting SIGNUPS_DOMAINS_WHITELIST accordingly.

More information

Require email verification to finish the registration.

Require new device emails. When a user logs in an email is required to be sent.

Even when registration is disabled (SIGNUPS_ALLOWED), organization administrators or owners can invite users to join organization.

More information

Activated the admin page. This page allows server administrators to view all the registered users and to delete them. It also shows inviting new users, even when registration is disabled.

More information

Secure the ADMIN_TOKEN

If you have another method to authenticate the admin page then you can set the DISABLE_ADMIN_TOKEN variable to true.

More information

The domain of your vaultwarden instance (should be the same as VIRTUAL_HOST).

This is required for U2F and FIDO2 WebAuthn authentication.

More information

You need a YUBICO_CLIENT_ID and YUBICO_SECRET_KEY to allow authentication with a Yubikey.

If YUBICO_SERVER is not set the default YubiCloud servers are used.

More information

• SMTP_HOST: The host server of the mail server
• SMTP_FROM: the mail address which should be used for sending mails
• SMTP_FROM_NAME: the name which should be used for sending mails
• SMTP_PORT: the port of the smtp server
• SMTP_SECURITY: the protocol that should be used (default: starttls, options: force_tls, off, starttls)
• SMTP_USERNAME: the username of the smtp user
• SMTP_PASSWORD: the password of the smtp user
• SMTP_EMBED_IMAGES: embed images as email attachments

This requires to set the DOMAIN variable.

More information

Usually, password hints are sent by email. But as vaultwarden is made with small or personal deployment in mind, hints are also available from the password hint page, so you don't have to configure an email service.

More information

Controls whether users can change their email. This setting applies globally to all users.

• LOG_LEVEL: options are: "trace", "debug", "info", "warn", "error" or "off". NOTE: Using the log level "warn" or "error" still allows Fail2Ban to work properly.
• USE_SYSLOG
• EXTENDED_LOGGING

More information

More information

To enable the push notifications you have to get a Hosting Installation id and Key from here.

PUSH_ENABLED=true
PUSH_INSTALLATION_ID=CHANGEME
PUSH_INSTALLATION_KEY=CHANGEME

To use "European Data" Region set these variables (default):

PUSH_RELAY_URI=https://push.bitwarden.eu
PUSH_IDENTITY_URI=https://identity.bitwarden.eu

if you want to use the "US Data" region use these instead:

PUSH_RELAY_URI=https://push.bitwarden.com
PUSH_IDENTITY_URI=https://identity.bitwarden.com

Controls whether users are allowed to create Bitwarden Sends.

Controls whether users can enable emergency access to their accounts.