Skip to content

Enabling Mobile Client push notification

Stefan Melmuk edited this page Aug 22, 2023 · 19 revisions

Since version 1.29.0 of Vaultwarden, you can activate Mobile Client push notifications to automatically sync your personal vault between the mobile app, the web extension and the web vault without the need to sync manually.

Enable Mobile Client push notification

  1. Go to https://bitwarden.com/host/ insert your email address and you'll get an INSTALLATION ID and KEY.
    ⚠️ Until #3752 is implemented, make sure to select bitwarden.com (United States) as Data Region.
    💡 The EU Data Region is currently not supported by Vaultwarden. If you have requested an INSTALLATION ID and KEY for bitwarden.eu (European Union), you need to either wait until the PR is merged and released, build Vaultwarden with necessary changes yourself, or you can simply request a new id/key pair for the US Data Region.

  2. Add the following settings to your docker-compose.yml (and make sure you insert the correct ID and the KEY from the previous step):

    environment:
      - PUSH_ENABLED=true
      - PUSH_INSTALLATION_ID=
      - PUSH_INSTALLATION_KEY= 
  1. Recreate your container, e.g. with
docker compose up -d vaultwarden
  1. Connect your app to your Vaultwarden instance.
    ⚠️ Unless you're using a freshly installed Bitwarden app, push notifications will not work with already connected clients. You have to clear the app data of your mobile app (or reinstall the app) and connect your Vaultwarden account again to register the push token with the Bitwarden's Azure Notification Hub.
    💡 Push notifications will also only work on Bitwarden apps installed from the official mobile stores (App Store, Google Play Store) or when using alternative clients for the Google Play Store (such as Aurora Store). Push notifications will not work using Bitwarden clients installed from F-Droid, NeoStore or other alternative stores. Those apps have been built without support for Firebase Messaging.

  2. Test if mobile push notifications work, for example by renaming a folder in the web vault and see if it changes after a few seconds in your mobile app.

FAQs

  1. FAQs
  2. Audits
  3. Supporting upstream development

Troubleshooting

  1. Logging
  2. Bitwarden Android troubleshooting

Container Image Usage

  1. Which container image to use
  2. Starting a container
  3. Using Docker Compose
  4. Using Podman
  5. Updating the vaultwarden image

Reverse Proxy

  1. Proxy examples
  2. Using an alternate base dir (subdir/subpath)

HTTPS

  1. Enabling HTTPS
  2. Running a private vaultwarden instance with Let's Encrypt certs

Configuration

  1. Overview
  2. Enabling admin page
  3. SMTP configuration
  4. Disable registration of new users
  5. Disable invitations
  6. Enabling WebSocket notifications
  7. Enabling Mobile Client push notification
  8. Enabling SSO support using OpenId Connect
  9. Other configuration

Database

  1. Using the MariaDB (MySQL) Backend
  2. Using the PostgreSQL Backend
  3. Running without WAL enabled
  4. Migrating from MariaDB (MySQL) to SQLite

Security

  1. Hardening Guide
  2. Password hint display
  3. Enabling U2F and FIDO2 WebAuthn authentication
  4. Enabling YubiKey OTP authentication
  5. Fail2Ban Setup
  6. Fail2Ban + ModSecurity + Traefik + Docker

Performance

  1. Changing the API request size limit
  2. Changing the number of workers

Customization

  1. Translating the email templates
  2. Translating admin page
  3. Customize Vaultwarden CSS
  4. Using custom website icons
  5. Disabling or overriding the Vault interface hosting

Backup

  1. General (not docker)
  2. Backing up your vault

Development

  1. Building binary
  2. Building your own docker image
  3. Git hooks
  4. Differences from the upstream API implementation

Alternative deployments

  1. Pre-built binaries
  2. Creating a systemd service
  3. Third-party packages
  4. Deployment examples
  5. Disable the admin token

Other Information

  1. Importing data from Keepass or KeepassX
  2. Changing persistent data location
  3. Syncing users from LDAP
  4. Caddy 2.x with Cloudflare DNS
  5. Logrotate example
Clone this wiki locally