Two Factor Authentication

Two-factor authentication is supported and will automatically be detected, however additional steps are required to enter your verification code.

Wyze API Key/ID

Starting with v2.3.0, two-factor authentication can be skipped entirely by setting the API_KEY and API_ID.

environment:
    - API_ID=My-Unique-App-ID-From-WYZE
    - API_KEY=MySecretKeyFromWyze

See the official support page for generating your key and ID: https://support.wyze.com/hc/en-us/articles/16129834216731

Note: the key and ID are unique to a single account, so you will need to generate a new set for each account.

WebUI

Starting with v1.8.7, visiting the WebUI should give you a form where you can submit your 2FA code.

Auto generate a TOTP

You can have the bridge auto generate and enter a Time-based One-Time Password (TOTP) by setting the TOTP_KEY in your docker-compose.yml with the code from the Wyze App:

environment:
    - TOTP_KEY=MYSECRETKEY12345

This can also be done by adding the secret key to the file /tokens/totp on standard installs or /config/wyze-bridge/totp for Home Assistant installs. You will need to create the file if it doesn't exist and mount it if necessary.

Docker

• Echo the verification code directly to /tokens/mfa_token.txt by opening a second terminal window and using:

  docker exec -it wyze-bridge sh -c 'echo "123456" > /tokens/mfa_token.txt'

• Mount /tokens/ locally and add your verification code to a file named mfa_token.txt:

  volumes:
      - ./tokens:/tokens/

Home Assistant

Add your code to the text file: /config/wyze-bridge/mfa_token.txt.

Portainer

Use the console to echo your code to the container:

echo "123456" > /tokens/mfa_token.txt