Skip to content

Install & update UniFi Controller on a Fireawlla Gold & Purple series

License

Notifications You must be signed in to change notification settings

mbierman/unifi-installer-for-Firewalla

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Install UniFi Controller in Docker on Firewalla Gold Series Boxes


Note, although this installer also works on Firewalla Purple, I have seen people have trouble running large docker images on Purple so I caution that this may be too taxing for Puprle. To my knowledge, Firewalla hasn't made any official statement about this, but I felt a warning was justified.

I haven't run the controller on Purple SE so I can't give advice, but I would be cautious about doing this.


This is a script for installing the UniFi docker container on Firewalla Gold series boxes. It is based on the Firewalla tutorial and has been tested on 1.974 and above.

To install:

  1. SSH into your Firewalla (learn how if you don't know how already.)

  2. Copy the line below and paste into the Firewalla shell and then hit enter.

curl -s -L -C- "https://raw.githubusercontent.com/mbierman/unifi-installer-for-Firewalla/main/unifi_docker_install.sh?$(date +%s)" | 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 compromise security. Happy to answer questions though if I can. :)

Updating docker

From time to time unifi will update the Controller. After vetting it for a while, the owner of the container will update the image. This is a good thing. It means you get some confidence it will run when you update it. I wrote a script to do the updates. I watch when the container is updated and then run the script. You could do this via a cron job (e.g. once a week run the update and if there isn't one it will just exit) but I don't tend to do that since if it goes poorly my controller could be down.

To update the unifi docker container in the future, go to:

/home/pi/.firewalla/run/docker

and run

./updatedocker.sh unifi

Uninstalling

The installer script will remove the unifi docker and ALL related data. If you want to start from square one, you can use this. But be warned, I mean square one. It is currently set to remove all the docker data. I may make it more forgiving in the future, but if things aren't working and you need to start over, this should get you there.

If you want more of a piecemeal approach, see below.

Using an uninsall script

  1. ssh to your firewalla. User is always pi and the password comes from the Firewalla app.
  2. Run
curl -s -L "https://raw.githubusercontent.com/mbierman/unifi-installer-for-Firewalla/main/unifi-uninstall.sh?$(date +%s)" | bash

You should now be back to a clean slate and ready to re-install if you choose do do so.

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

About

Install & update UniFi Controller on a Fireawlla Gold & Purple series

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages