Skip to content

mbierman/homebridge-installer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Install Homebridge Docker Container on Firewalla Gold, Gold SE, Gold Pro 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.

⚠️ Note: One user reported that the latest homebridge is no longer working with firewalla boxes running Ubuntu 18.x. If you want to run Homebridge on firewalla, I recommend flashing to the latest firewalla release

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:

image

And the CPU temperatures: image

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 stop homebridge 
sudo docker container rm homebridge
cd /home/pi/.firewalla/run/docker/homebridge && sudo docker-compose down
sudo docker image rm -f ubuntu/homebridge
sudo rm -f /home/pi/.firewalla/run/docker/homebridge/docker-compose.yaml && \
sudo rm -rf /data/homebridge /home/pi/.firewalla/run/docker/homebridge
sudo docker system prune -af

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.