Console setup helper for initial configuration

[gsanchietti]

Description

Add a console-first setup helper (/usr/sbin/setup) that guides administrators through basic initial configuration using an interactive whiptail menu interface.

This tool is essential for headless deployments where web UI access is not yet available. It enables:

• Keyboard layout selection (it/us, applied immediately)
• LAN interface configuration (device, protocol, IPv4)
• WAN interface configuration (device, protocol, IPv4, gateway)

The tool reads current network configuration via the ns.devices RPCD API and applies changes via ns.commit.

Use case

On first boot with console-only access, administrators can set keyboard layout, configure LAN/WAN interfaces, and commit changes atomically.

Alternative solutions

• Manual UCI file editing (not user-friendly)
• Pre-configured images (inflexible for different topologies)
• DHCP for all interfaces (may not work in all environments)

References

• API: ns.devices (configure-device)
• API: ns.commit (atomic transactions)

[gsanchietti]

Testing image: 8.8.0-dev.48.20260618123503.3d9c060

Test cases

T1: Keymap switching

• Start setup, select Keymap
• Change from us to it; verify typing layout changes immediately on console
• Switch back to us; verify layout resets without reboot
• Verify /etc/keymap contains the selected value

T2: LAN configuration — static IPv4

• Select Network → LAN
• Select a physical network device (e.g., eth0)
• Choose static protocol
• Enter a valid IPv4 address in CIDR notation (e.g., 192.168.1.1/24)
• Apply changes
• Verify /etc/config/network shows the LAN interface with the assigned IP

T3: LAN configuration — DHCP

• Select Network → LAN
• Choose DHCP protocol
• Apply changes
• Verify interface is configured as DHCP in UCI

T4: WAN configuration — static IPv4

• Select Network → WAN
• Select a different physical device from LAN
• Choose static protocol
• Enter valid IPv4 address (e.g., 1.2.3.4/24)
• Enter valid gateway (e.g., 1.2.3.1)
• Apply changes
• Verify WAN interface is configured correctly in UCI

T5: WAN configuration — DHCP

• Select Network → WAN
• Choose DHCP protocol
• Apply changes
• Verify WAN is in DHCP mode

T6: No apply when unchanged

• Enter Network menu without making any changes
• Select Apply Changes
• Verify message: 'No network changes to apply'
• Verify UCI config is not touched

T7: Cancel without applying

• Make network changes (e.g., change LAN IP)
• Press Cancel/Exit button (or select 'Exit without applying')
• Verify confirmation dialog appears: 'You have unsaved network changes'
• Choose 'No' → return to main menu
• Choose 'Yes' → exit without applying
• Verify changes were not persisted

T8: Invalid input validation

• Try entering an invalid IPv4 address (e.g., '999.999.999.999')
• Verify inline error message and re-prompt
• Try entering non-CIDR format (e.g., '192.168.1.1' without prefix)
• Verify re-prompt with error
• Enter valid value on retry

T9: Device selection exclusivity

• Assign eth0 to LAN
• Try to assign eth0 to WAN
• Verify error: 'LAN and WAN must use different devices'
• Verify config is not applied

T10: Persistence across reboots

• Configure LAN static IP (e.g., 192.168.100.1/24)
• Apply and exit
• Reboot device
• Verify IP is present on interface after boot

[francio87]

T1 👎🏻 : Can't switch back to US: "Unable to apply keymap immidiatly"

root@NethSec:~# setup
/usr/sbin/setup: line 1029: can't open /usr/share/keymaps/us.map.bin: no such file

T2 : OK 👍🏻

T3: Not Ok 👎🏻 clientid=None and vendorid=None get added to the configuration :

root@NethSec:~# uci show network.lan
network.lan=interface
network.lan.device='eth0'
network.lan.proto='dhcp'
network.lan.clientid='None'
network.lan.vendorid='None'

This prevent the DHCP Client to work :

Jun 18 15:55:45 NethSec netifd: Interface 'lan' is now down
Jun 18 15:55:45 NethSec netifd: Interface 'lan' is setting up now
Jun 18 15:55:45 NethSec netifd: lan (7089): udhcpc: malformed hex string 'None'

T4 : OK 👍🏻

T5 : OK 👍🏻

T6 : OK 👍🏻

T7 : OK 👍🏻

T8 : OK 👍🏻

T9 : OK 👍🏻

T10 : OK 👍🏻