diff --git a/Documentation/network.md b/Documentation/network.md index 377ba781a..d36d997a7 100644 --- a/Documentation/network.md +++ b/Documentation/network.md @@ -1,14 +1,15 @@ # Network -HassOS uses NetworkManager to control the host network. In future releases, you will be able to set up the configuration using the API/UI. Currently only manual configuration using NetworkManager connection files is supported. Without a configuration file, the device will use DHCP by default. These network connection files can be placed on a USB drive as described in [Configuration][configuration-usb]. +HassOS uses NetworkManager to control the host network. In future releases, you will be able to set up the configuration using the API/UI. Currently only a manual configuration using NetworkManager connection files is supported. Without a configuration file, the device will use DHCP by default. These network connection files can be placed on a USB drive as described in [Configuration][configuration-usb]. ## Configuration Examples -You can also read the [Official Manual][keyfile] or there are a lot of examples accross internet. The system is read only, if you don't want the IP address to change every boot, you should set the uuid property with a generic [UUID4][uuid]. Inside the `network` folder create the file `my-network` and add the appropriate contents below: +You can also read the [Official Manual][keyfile] or there are a lot of examples accross internet. The system is read-only, if you don't want the IP address to change every boot, you should set the UUID property with a generic [UUID4][uuid]. Inside the `network` folder create the file `my-network` and add the appropriate contents below: ### Default We have a preinstalled connection profile: + ``` [connection] id=HassOS default @@ -24,6 +25,7 @@ method=auto ``` ### LAN + ```ini [connection] id=hassos-network @@ -39,6 +41,7 @@ method=auto ``` ### Wireless WPA/PSK + ```ini [connection] id=hassos-network @@ -64,7 +67,8 @@ method=auto ### Static IP -Replace follow configs: +Replace follow configuration: + ```ini [ipv4] method=manual @@ -76,7 +80,8 @@ dns=8.8.8.8;8.8.4.4; ### Reset network -If you want reset the network configuration to default, use follow commands on host: +If you want reset the network configuration to default, use follow commands on the host: + ```bash $ rm /etc/NetworkManager/system-connections/* $ cp /usr/share/system-connections/* /etc/NetworkManager/system-connections/ @@ -86,6 +91,7 @@ $ nmcli con reload ### Powersave If you have trouble with powersave you can do following: + ```ini [wifi] # Values are 0 (use default), 1 (ignore/don't touch), 2 (disable) or 3 (enable).