Install Homebridge Docker Container on Firewalla Gold or Purple

This is a script for installing the Homebridge docker container on Firewalla Gold or Purple. It should get you up and running. It is based on the Firewalla tutorial.

To install, learn how to ssh into your firewalla if you don't know how already.

Beyond that, all you need to know to get this running is how to copy/paste.

Next, copy the line below and paste into the Firewalla shell and then hit Return.

curl -s -L -C- https://raw.githubusercontent.com/mbierman/homebridge-installer/main/homebridge_docker_install.sh | cat <(cat <(bash))

Standard disclaimer: I can not be responsible for any issues that may result. Nothing in the script should in any way, affect firewalla as a router or comprimise security. Happy to answer questions though if I can. :)

What is Homebridge?

Homebridge is a lightweight NodeJS server you can run on your home network that emulates the iOS HomeKit API. It supports Plugins, which are community-contributed modules that provide a basic bridge from HomeKit to various 3rd-party APIs provided by manufacturers of "smart home" devices.

Since Siri supports devices added through HomeKit, this means that with Homebridge you can ask Siri to control devices that don't have any support for HomeKit at all."

Why run homebridge on Firewalla?

You can run Homebridge on lots of devices. If you don't have a NAS or Raspberry Pi around, and you are a Fireawlla user, you can run it right on your Firewalla appliance. You can use this for all the usual homebridge things, but most interesting to me was to monitor Firewalla's own stats. You also get dashboard readings about CPU load and memory consumption:

And the CPU temperatures:

Now you can see Firewalla's temperature as a homekit sensor. To fully configure this for Firewalla specifically, see the Firewalla guide.

Updating docker

Here's a script for updating docker containers.

Restarting after Firewalla update or reboot

Here's a script for restarting Homebridge after reboots and FW upgrades.

Uninstalling

If you need to reset the container (stop and remove and try again) run the following commands.

WARNING: if you use these commands you are stopping and removing the container. Don't do this unless you are sure that you don't mind potentially losing your homebridge configuration. If you haven't managed to get the Controller running then there is probably no harm in this: nothing to lose.

Otherwise, only do this if you know at least a little bit about what you are doing. And always backup.

# This stops the homebridge container and removes it to get you back to a clean state.
sudo docker update --restart=no homebridge && \
sudo docker-compose down && \
sudo docker stop homebridge && \
sudo docker rm -f homebridge && \
sudo docker system prune -af && \
sudo docker image rm -f ubuntu/homebridge, \
sudo docker image rm ubuntu/homebridge && sudo docker system prune, \
sudo rm -f ~/.firewalla/run/docker/homebridge/docker-compose.yaml , \
sudo rm -rf /data/homebridge

You can also use the resetdocker.sh script to reset docker to a prestine state.

There are lots of homebridge communities on Reddit and discord. If you have homebridge questions, please check there.