Docs  /  Network IP / DNS Auto-Configuration

Network IP / DNS Auto-Configuration

Optional discovery of local IP addresses and DNS names, with an opt-in apply path that can fill computer_hostname and refresh service host settings.

Discover (always safe)

net autoconfig discover
network ip
net autoconfig status
net autoconfig resolve jupiter.example.com
net autoconfig reverse 10.0.0.151

Discovery reports:

  • short hostname, FQDN, DNS suffix
  • preferred IPv4 / IPv6 (skips loopback and link-local when possible)
  • all adapter addresses
  • DNS server IPs (Windows)

Cached globals after refresh:

network_local_ipv4
network_local_ipv6
network_local_hostname
network_local_fqdn
network_dns_suffix

Enable auto-configuration

Auto-config is off by default. Turn it on explicitly:

net autoconfig enable
net autoconfig prefer-dns          # identity = FQDN/hostname (default)
net autoconfig prefer-ip           # identity = preferred IPv4
net autoconfig services on         # also rebind localhost LLM/Whisper URLs to LAN IP
net autoconfig resolve-remote on   # resolve remote MySQL/LLM/FTP DNS names (report)
net autoconfig dry-run             # show planned changes
net autoconfig apply               # apply + save settings
net autoconfig startup on          # apply cache + config on process start

What apply changes

Target When Behavior
network_local_* cache always Filled from discovery
computer_hostname apply_computer (default on) Set to preferred identity (DNS or IP)
mysql_hostname apply_services Only if empty/localhost/auto → localhost
llm_hostname / whisper_hostname apply_services If host is localhost, rewrite to preferred IPv4
remote MySQL / LLM / FTP resolve_remote Resolve DNS and print IPs (names kept)

Settings menu

Computer Settings items 19–24:

  • enable/disable auto-config
  • discover IPs/DNS
  • dry-run / apply
  • prefer DNS vs IP
  • apply on startup

Settings keys

network_auto_config_enabled=false
network_auto_config_apply_on_startup=false
network_auto_config_prefer_dns=true
network_auto_config_apply_computer=true
network_auto_config_apply_services=false
network_auto_config_resolve_remote=true

Implementation

  • NetworkAutoConfig.hpp / NetworkAutoConfig.cpp
  • Windows: GetAdaptersAddresses, GetComputerNameEx, getaddrinfo / getnameinfo
  • Wired into net …, network …, startup (ApplyOnStartupIfEnabled), and _Computers::GetHostname()
Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.