This is a quick guide on installing UniFiPi; which can be downloaded from the downloads page.

Step 1 – Download and Extract

When you Unzip you should see a .img file, this is the file used image the SD card

    Step 2 – Burn Image to SD Card

    • Download Etcher
    • Open and select both the SD card and the .img file then click “Flash!”

    Step 3 – Boot Up Raspberry Pi

    • Put SD card into Raspberry Pi
    • Plug in all required cables
    • Wait up to 5 minutes for Raspberry Pi to Boot

    Step 4 – Browse to Web Interface and Configure Controller

    Where to go from here?



    Erik · June 7, 2018 at 8:36 am

    Thanks for what looks like a very promising product! I have the latest version and it asks me for username and password during the boot up. Is this correct? On that case what is the username and password?

      Kowen · June 7, 2018 at 1:09 pm

      Hey Erik,

      You’ll need to provide more details about your issue. The username and password are provided on the getting started page (user: pi password: raspberry). I’m guessing you have a screen plugged into the raspberry pi? You only need power and ethernet plugged into the raspberry pi and all other configuration is done from another computer by going to https://unifipi.local


    Jonas Strand · June 15, 2018 at 2:04 am

    Thanks for making a nice image for Unifi, seems promising!
    I have a problem though.
    When i start up the pi, for the first time, i cant log into the Unifi Controller, but i can get into Webmin. I am getting to the part where i have to make an exception for the HTTPS certificate, but after that, it just loads forever. And restarting the pi doesnt help. Any idea why?

    Jonas Strand

      Kowen · June 15, 2018 at 9:00 am

      Hey Jonas,

      That’s interesting, You should check a few things:
      * What version of Pi are you using? (UniFiPi officially supports Pi 2 and 3B, if you are using an older version give it 10 minutes to load or so)
      * Have you tried another, higher current, power supply with your Pi? (Sometimes not having enough power can cause odd issues, even check the cable. I’ve had dud cables before, causing weird issues…)
      * What speed is your SD card? Is it corrupt? Is it old? Have you tried a different one?

      Let me know how you get on!

        Jonas Strand · June 15, 2018 at 9:14 am

        Hey, thanks for the quick answer!

        I am using a Pi 3B, so i guess its good.
        The power supply is rated at 2 amps, but i will try switching it with a stronger one.
        The SD card is the one that came with it, 16 gigs and class 10, so i dont think thats the problem, but who knows.
        You will hear back from me when i have tried switching stuff 😀

        Jonas Strand

    Brett Kruger · June 27, 2018 at 10:24 pm

    This is a great little product but 2 questions, how do I change the root and pi account passwords, and when do I go to change to a static IP address?

      Kowen · June 29, 2018 at 2:49 pm

      Hey, thanks for the question.
      Go to https://unifipi.local use the username pi and password raspberry to log in. From there to change the passwords you go to system -> change passwords -> Click on the user you want to change the password for and then click change password. To set a static IP addresss, within webmin, click networking -> network configuration -> network interfaces -> Active now Tab -> eth0 -> ipv4 address -> save.


    Frank · July 6, 2018 at 7:18 pm

    Hi Kowen,
    nice piece of work!
    I had the same problem as Jonas. The Web-Interface loads forever. I also tried different browsers and platforms (e.g. on Android). Same problem. I was using a Pi B+ V1.2 with a 2.5 Amp power suppl, which worked fine with other images.
    Now I switched to a Raspi 3 Model B V1.2 with the same SD card and power supply. This one works out of the box. Strange!
    What is the console login? Maybe I could take a look at the log files.

      Kowen · July 10, 2018 at 11:05 am

      Hey Frank,

      thanks for that. That’s interesting I wonder what’s going on there.
      You’ll need to enable SSH and allow port 22 in webmin, sorry I don’t have a tutorial on that just at this stage.


    Clinton Peterson · July 21, 2018 at 3:03 am

    Hey Kowen,

    Just loaded this up and it looks like a fantastic package. I have so many PIs laying around and this was a great use for 1 of them.

      Kowen · July 23, 2018 at 11:01 am

      Hey Clinton,

      Glad to help out!


    Pieter-Jan Dominicus · August 9, 2018 at 6:23 pm

    Hey Kowen,

    Is the image compatible with PI Model 3B+ or do you have plans to support it?

      Kowen · August 9, 2018 at 9:42 pm

      Hi Pieter,

      I’m not sure if this runs on 3B+. I assume it does, but not officially supported because I don’t have one *yet*! 🙂


    Leave a Reply

    Your email address will not be published. Required fields are marked *

    This site uses Akismet to reduce spam. Learn how your comment data is processed.