Legacy Setup

Please check the First Boot Guide if you setup the eManager for the first time.

Ethernet settings

Only valid for images release before 22.10. Newer versions use the eManager WebAdmin.

We explain here how to configure the eManager Ethernet with static IP, dynamic IP address, or both.

Check: systemd.network for further information.

Edit the Ethernet network configuration file /etc/systemd/network/20-eth0.network with

nano /etc/systemd/network/20-eth0.network

Then copy and paste one the following code blocks.

Static IPDynamic IPCombined

[Match]
Name=eth0

[Network]
DNS=10.1.10.1

[Address]
Address=10.1.10.10/24

[Route]
Gateway=10.1.10.1
Metric=400

[Match]
Name=eth0

[Network]
DHCP=yes

[DHCP]
RouteMetric=100

[Match]
Name=eth0

[Network]
DHCP=yes
LinkLocalAddressing=yes
LLMNR=yes
MulticastDNS=yes
LLDP=yes
EmitLLDP=yes
DNS=10.1.10.1

[Address]
Address=10.1.10.10/24

[Route]
Gateway=10.1.10.1
Metric=400

[DHCP]
RouteMetric=100

Restart the service:
```
systemctl restart systemd-networkd
```
Check if IP address is correctly assigned using
```
ip addr
```

WiFi settings

Only valid for images release before 22.10. Newer versions use the eManager WebAdmin.

WiFi network configuration file is stored in /etc/systemd/network/21-wlan0.network. You can configure WiFi as STA or AP/Hotspot mode.

STA mode

WiFi can work in only one mode at a time. Disable one mode before enabling the other.

This is a step-by-step guide for connecting to a WPA/WPA2 WiFi network.

Command line tools used:

iw: is the basic tool for WiFi network-related tasks, such as finding the WiFi device name, and scanning access points.
wpa_supplicant: is the wireless tool for connecting to a WPA/WPA2 network.
systemctl: is a tool to control the Linux systemd system and services.
ip: is used for enabling/disabling devices, and finding out general network interface information.

Steps:

Edit WiFi configuration file

nano /etc/systemd/network/21-wlan0.network

Replace its content with following lines:

[Match]
Name=wlan0

[Network]
DHCP=yes
LLMNR=yes
MulticastDNS=yes
LLDP=yes
EmitLLDP=yes

[DHCP]
RouteMetric=200

Save and exit: Ctrl+X. Confirm save with Y.

Restart service with
```
systemctl restart systemd-networkd
```

Scan WiFi network(s) with

iw wlan0 scan

See SSIDs only with

iw wlan0 scan | grep SSID

Configuration file generation. You must generate a configuration file for wpa_supplicant that contains the pre-shared key ("passphrase") for the WiFi network.

wpa_passphrase takes the SSID as the single argument. You must type in the passphrase for the chosen WiFi network after you run the command. Using that information, wpa_passphrase will output the necessary configuration statements to the standard output. Those statements are appended to the wpa_supplicant configuration file located at /etc/wpa_supplicant.conf.

wpa_passphrase <SSID chosen by you> >> /etc/wpa_supplicant/wpa_supplicant-wlan0.conf

Type the WiFi passphrase and hit enter. You can view now the generated statements:
```
cat /etc/wpa_supplicant/wpa_supplicant-wlan0.conf
```
Start wpa_supplicant service to connect to WPA/WPA2 WiFi network
```
systemctl start wpa_supplicant@wlan0.service
```
If you need to connect automatically at each startup, you must enable the service using:
```
systemctl enable wpa_supplicant@wlan0.service
```
Check the connection status and the assigned IP address
```
iw wlan0 link
ip a | grep wlan0
```

For further information, please check: systemd.network.

AP / Hotspot mode

WiFi can work in only one mode at a time. Disable one mode before enabling the other.

Edit WiFi configuration file

nano /etc/systemd/network/21-wlan0.network

Replace the file content with:

[Match]
Name=wlan0

[Network]
Address=192.168.0.1/24
DHCPServer=yes
IPForward=no
IPMasquerade=no

Save and exit: Ctrl+X. Confirm save with Y.

Restart service
```
systemctl restart systemd-networkd
```

Edit hostapd WiFi configuration file

nano /etc/hostapd.conf

Replace the following lines (set desired WiFi password instead of eMANAGER-password. It must have a minimum of 8 characters):

logger_syslog=-1
logger_syslog_level=2
logger_stdout=-1
logger_stdout_level=2
ctrl_interface=/var/run/hostapd
ctrl_interface_group=0
auth_algs=1
beacon_int=50
channel=3
country_code=ES
disassoc_low_ack=1
driver=nl80211
hw_mode=g
ieee80211d=1
ieee80211n=1
interface=wlan0
require_ht=0
rsn_pairwise=CCMP
ssid=eMANAGER
wmm_enabled=1
wpa=2
wpa_key_mgmt=WPA-PSK
wpa_passphrase=<eMANAGER-password>

Introduce the password of your eManager in the wpa_passphrase field. Save and exit: Ctrl+X. Confirm save with Y.

Set service at startup and start it

systemctl enable hostapd
systemctl start hostapd

Connect client via Wifi