How to Load Home Assistant on to a Raspberry Pi

  1. Gather Materials
  1. Build your new raspberry pi
  1. Download Hassio for the Raspberry Pi 3
    if you are using a different Pi, find your download on Home Assistant’s Hassio Page)
  2. Download and install the latest version of balenaEtcher
  3. Plug your new microSD card into your computer using your adapter
  4. Open balenaEtcher
  1. Your SD Card is now ready! If you plan to connect directly to your router via network cable (recommended), skip ahead to step 30. If you plan to use wireless settings, follow the next few steps to add wireless configuration
  2. Unplug and plug back in your SD card reader into your computer.
  3. Navigate to your new HASSOS directory.
  1. Create a new folder, “CONFIG” and open it.
  1. Create a new folder “Network”, and open it.
  1. Right click in the new folder and create a new text file name “my-network.txt”, and open it
  1. Go to and get a unique uuid.
  2. Paste UUID here:
  3. Enter your Wireless Router Name:
  4. Enter your WiFi Password: Note!
    We don’t store any of this. Data is simply transferred to the block below. If you don’t feel comfortable adding it here, you can edit your file after you paste it
  5. Copy the below block and paste it into your new “my-network.txt”
  6. Alternatively, you can use our LAN Configuration Tool
uuid=Unique UUID

# Uncomment below if your SSID is not broadcasted 




  1. Save your text file and close out of notepad.
  2. Navigate back to the network folder you just created and ensure that “File name extensions” is enabled.
  1. Rename “my-network.txt” to “my-network” (no extension) and hit enter.
    If you need to revisit your configuration file, you can always right click the file and edit with notepad. Notepad will see it the same as if it were a .txt file.

  1. “Safely Remove” your SD Card from your computer
  2. Insert SD into your Pi
  1. Plug in your pi to its power supply.
  2. Wait about 2-3 minutes for you Pi to register and connect to your network.
  3. Launch your preferred web browser and navigate to “hassio.local:8123“.
    If your router does not support mDNS, you will need to navigate directly to the IP address of the Pi. You can discover this by going to your router settings and looking at attached devices. This should show up as HASSIO. It would be something like Be sure to add “:8123” to the end. This is the port number that HASSIO is hosted.
  4. If everything worked, you should see a page telling you that Hassio is setting itself up. This process took me about 10 minutes, but it could take longer.
  1. Once the install is complete, the site above will go down for a minute or two, then the config screen will come up.
  2. Set your name, username, and password. Be sure to make a secure password, this device will control your whole house!
  1. Set your home address, preferred units, and time zone.
  1. Your Home Assistant might find some devices on your network automatically. It will ask you if you want to set these up.
  2. Here, you can also select additional devices you might have. Simply click “more”, find your device, and follow the instructions to add.
  1. Go ahead and check out what is offered. You can revisit all of this again later.
  2. Once done, click “done”.
  3. You’re all set! Once your homescreen loads up, you will be asked if you want to save your log in.
    This will save you time in the future, but will keep your Home Assistant logged in on this computer indefinitely. Only Save Login if you trust everyone that has access to this browser.

Your Home Assistant is ready for you to start configuring! You can learn what kind of devices your new smart home can work with by checking out Home Assistant’s list of supported components. Here you can learn how to add each to your system, which consists of edition your configuration file, which I will cover in the next post.

If there is anything I missed or if you want to see me cover something in particular, leave feedback below!


  1. […] Previously, I wrote a guide on how to get started on Home Assistant, an open-source, home automation platform that puts local control and privacy first. This guide is how to expand upon this build to create an all-in-one controller and touch panel using Tileboard. This guide will take you from scratch and end with a touch panel that can control (almost) all devices that are connected to your Home Assistant, including Hue smart lights, smart switches, and your media center, depending on how extensive your smart home is. […]

  2. Richard Coopmans

    Great and easy to follow guide, thanks mate!
    I’ll be starting my home automation soon and these guides really help

    1. Tyler

      Thanks Richard!

      I’m actually looking for feedback on which tutorial to write next. I created a quick poll if you want to vote on the next one. (Link)

      Good luck with the build!

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.