Getting Started with Docker on Raspberry Pi (for Wyze Bridge)
If you’re new to Docker, don’t worry—it’s easier than it looks! Docker lets you run applications in containers, which are like lightweight, self-contained packages that include everything needed to run the software.
Connecting to Your Raspberry Pi with PuTTY (Windows)
Before we install Docker, you’ll need to connect to your Raspberry Pi remotely using SSH.
First, enable SSH on your Raspberry Pi. If you have a monitor connected, go to Raspberry Pi Configuration and enable SSH. If you’re doing a headless setup, create an empty file named ssh (no extension) in the boot partition of your SD card before first boot.
Download and install PuTTY from putty.org if you don’t have it already.
Open PuTTY and enter your Raspberry Pi’s IP address in the “Host Name” field. You can find the IP address by checking your router’s connected devices or using a network scanner app.
Click “Open” to connect. You’ll get a security alert the first time—click “Yes” to accept.
Log in with your Raspberry Pi credentials (default is usually username: pi, password: raspberry, though you should change this for security).
Installation Steps
Now that you’re connected via SSH, start by updating your Raspberry Pi:
sudo apt update && sudo apt upgrade
Install Docker using the official script:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Add your user to the docker group so you don’t need sudo every time:
sudo usermod -aG docker $USER
Then log out and back in (close PuTTY and reconnect) for this to take effect.
Verify Docker is working:
docker --version
Installing Docker Compose
Docker-Wyze-Bridge uses Docker Compose, which makes managing containers much simpler. Install it with:
sudo apt install docker-compose
Running Wyze Bridge
Once Docker is set up, watch my video tutorial and follow the documentation linked in the video description. The docker-compose.yml file doesn’t need editing, but you will need to create secrets files with your Wyze credentials.
Video: https://youtu.be/N93vWAGRemU
Creating Secrets Files
Create a .secrets folder in the same directory as your docker-compose.yml file:
mkdir .secrets
Use sudo nano wyze_email.txt to open a new file; then right mouse click and paste Wyze credential. Press Ctrl O to write file; then Ctrl X to exit. Repeat for all Wyze credentials; use separate filenames for each! Have to use filenames in documentation.
Then create the following text files in the .secrets folder with your Wyze account information:
-
.secrets/wyze_email.txt - Your Wyze account email
-
.secrets/wyze_password.txt - Your Wyze account password
-
.secrets/wyze_api_id.txt - Your Wyze API ID
-
.secrets/wyze_api_key.txt - Your Wyze API Key
Each file should contain only the credential (no extra spaces or lines).
After creating your secrets files and downloading the docker-compose.yml file, simply run docker-compose up -d in the directory with your compose file.
Key Benefits
-
No firewall configuration needed
-
No port forwarding required (works even with CGNAT providers like T-Mobile Home Internet)
-
No editing of the docker-compose.yml file necessary (just create simple secrets files)
-
Access from anywhere: Use Tailscale’s free tier to see your home network devices from anywhere there’s Internet!
```
Docker-Wyze-Bridge supported cameras
Important Note
Raspberry Pi uses ARM architecture, but Docker-Wyze-Bridge supports this, so you’re good to go!