Zum Hauptinhalt springen

Chapter 9: Network Configuration

This chapter describes how to configure the network interfaces of your Querx device, including Ethernet, WiFi (Client and AP mode), interface selection behavior, and discovery services.


Ethernet Interface

In default settings Querx configures the wired network connection automatically. This is referred to as dynamic configuration, as it is newly configured each time the device is booted, which can change the settings. Alternatively, the network settings can be configured manually. Manually assigning a static IP-address to the device will make it boot more quickly and also make it accessible at the same IP-address at all times.

info

Changes to the network settings will only be applied after the device has rebooted.

Open the configuration page:

System → Network

Click the Edit symbol next to the Ethernet entry to configure the network interface.

Dynamic Network Configuration

If your network supports DHCP, Querx can automatically obtain all required network parameters.

  1. Enable Dynamic mode.
  2. Click Connect to test the network connection.
  3. If the test is successful, click Save to apply your settings.
  4. The device will attempt to connect to the network using DHCP.

placeholder

If DHCP is successful, the assigned IP address is shown.

Static Network Configuration

If your network does not provide DHCP, or if you prefer to use a fixed IP address:

  1. Select Static mode.
  2. Enter the following parameters:
    • IP Address
    • Subnet Mask
    • Gateway
    • Primary DNS server
    • (optional) Secondary DNS server
  3. Click Connect to test the settings.
  4. If successful (button turns green), click Save.

If the test fails (button turns red), verify the data you entered and try again.

placeholder


WiFi Interface

To configure the WiFi interface, open:

System → Network

Click the Edit symbol next to the WLAN entry.

Client Mode

In Client Mode, Querx connects to your existing WiFi network.

  1. Ensure Client Mode is selected.

  2. Enable the WiFi interface.

  3. Click Scan to search for available WiFi networks.

    • Encryption modes appear automatically.
    • Signal strength is indicated by the number of dark bars.
    • Networks with weak signals may still be usable.
  4. Select the desired network from the list.

    • If the desired network is not listed, it may be hidden or out of range.
      Click Back to enter parameters manually.
  5. Enter the Shared Key (WiFi password).

  6. Click Connect to test the connection:

    • Green button → connection successful
    • Red button → connection failed
  7. Click Save to apply the settings.

placeholder

Client Mode Network Configuration

After selecting the WiFi network, configure the network layer:

  • Follow the same procedure described previously under Dynamic Network Configuration or Static Network Configuration for Ethernet.

AP Mode

Querx can also operate as a WiFi Access Point, allowing other devices to connect directly to it — even if no local WiFi network is available.

Activating AP Mode

  1. Ensure Access Point mode is enabled.
    • If not, click Change to Access Point.
  2. Enable the WiFi interface.
  3. Configure the AP parameters:
    • SSID (pre-filled with device name — can be changed)
    • Shared Key
      • A random key is generated automatically
      • Click the eye icon to reveal the key
      • You may replace it manually
    • Hidden mode
      • When enabled, the SSID will not appear in scans
      • Users must enter the SSID manually to connect
    • WiFi Channel
      Change only if necessary (e.g., interference)
  4. Click Save.

placeholder

AP Mode Network Configuration

By default, in AP mode the device uses:

  • IP Address: 192.168.10.1
  • Subnet Mask: 255.255.255.0
  • DHCP: Active, assigning dynamic IP addresses to clients

You may optionally assign your own static IP and subnet mask.
If provided, Querx will use those values instead of the default settings.


Selecting the Active Interface

Querx WLAN automatically chooses between Ethernet and WiFi based on availability:

  • If a working Ethernet connection is detected → Ethernet becomes active
  • If Ethernet is unplugged or unavailable → WiFi becomes active

Note: Querx must reboot to switch between interfaces.
This may take some time.

Status LED Indicators

  • Green flashing: Ethernet interface active
  • Blue flashing: WiFi interface active

If an alert occurs, LED behavior follows the rules described in Chapter 18: Configuring the Signalers.


Deactivating the Discovery Feature

Querx supports several discovery protocols that allow it to be found on local networks. These are enabled by default.

To change this, open:

System → Network

You can disable the following services for security reasons:

  1. Discovery Feature (Querx Hub Discovery)

    • Allows Querx Hub to list all devices on the local network
    • In larger setups, devices can be grouped by assigning port numbers
  2. mDNS (“Multicast DNS”)

    • Used mainly by macOS and some Linux systems
    • Allows access via:
      http://<systemname>.local/
  3. LLMNR (“Link-Local Multicast Name Resolution”)

    • Similar to mDNS, used by Windows systems by default
  4. Click Save to apply your settings.

Note:
If discovery services are deactivated, some applications may no longer be able to locate Querx automatically.