Confusing guide for newbies on first page of Hassio

Installation Home Assistant OS
1

Hi there!

I tried following this video guide which is presented here: https://www.home-assistant.io/hassio/ and it seems things have changed since it was created. The config files for Configurator and Samba are very different in the video guide from what we are presented now. And it is very confusing for newbies and I believe it also creates problems. Read below.

Here’s an example.

What it is presented in the video guide for the configurator:

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "certfile": "fullchain.pem",
  "keyfile": "privkey.pem",
  "ssl": false,
  "allowed_networks": [
    "192.168.0.0/16",
    "172.30.0.0/16"
  ],
  "banned_ips": [
    "8.8.8.8"
  ],
  "banlimit": 0,
  "ignore_pattern": [
    "__pycache__"
  ],
  "dirsfirst": false,
  "enforce_basepath": false
}

versus what we are given now:

{
  "dirsfirst": false,
  "enforce_basepath": false,
  "ignore_pattern": [
    "__pycache__"
  ],
  "ssh_keys": []
}

Like I said, it is very confusing, but also I think this is the reason why I couldn’t log in into hassio and had to reinstall from scratch 2 times. I blame the part with allowed_networks for this as my local network has IPs that start with 192.168.100.1. Not sure yet. But still. I wanted to let you all know about the confusions and for the newbies about the problems that it might create

2

Yes the configurator addon has changed but don’t define a trusted network if you don’t know what it means!

192.168.100.1 is a specific IP address… you would typically use 192.168.100.0/24 so the .0 can be any number from .1 to .255
192.168.0.0/16 means the 0.0 can be anything from 0.1 to 255.255 etc…

Yes it’s confusing when things change but no one is ‘paid’ to keep the docs up-to-date - that’s on all of us in this community. If you see an error in the docs, submit a PR to correct it.

3

Hi David!

Thank you for the informative answer.

192.168.100.1 is a specific IP address… you would typically use 192.168.100.0/24 so the .0 can be any number from .1 to .255

Can you explain some more how come 0/24 means the addresses can be from .1 to .255? So if I put 192.168.100.0/24, the last IP address would be 192.168.100.255? Do I understand correctly?

192.168.0.0/16 means the 0.0 can be anything from 0.1 to 255.255 etc…

I don’t know if I understand this and I would really like to.

Thank you for your help!

4

Actually I misspoke… it is anything from .1 to .254
The /xx says how many bits are reserved to define the subnet.
With x.x.x.x each x is 8 bits long (00000000 to 11111111 or FF in hex)
So a /24 means 24 bits define the network and the /24 is a ‘mask’ Sometimes you will see the subnet mask written as 255.255.255.0

Anyway, the 192.168.100.0/24 means the 192.168.100 part defines the network (24 bit mask) so when you say an allowed network is 192.168.100.0/24, it means it can be any ip from 1 to 254 for the last octet of the IP address.

There’s lots of good articles you can find on Google that will explain this way better than I have.

1 Like
5

254 actually.

And 255 is the broadcast address on the subnet.

1 Like
6

Yes you’re right… corrected the typo. Thanks.