Skip to content
VeloGuardian Docs

Console CLI

The console CLI is the text-based menu you see when you access the VM console directly through your hypervisor. It’s used for initial network setup and system administration tasks that don’t require the web dashboard.

Accessing the console

Section titled “Accessing the console”

Connect to the VM console through your hypervisor (VMware console, VirtualBox window, or Proxmox noVNC). The console menu loads automatically on boot — no login required.

Section titled “Menu options”

1. Network Configuration

Section titled “1. Network Configuration”

Configure the appliance’s network interface. Choose between:

DHCP — the appliance obtains its IP, gateway, and DNS automatically from your router.

Static — manually specify:

  • IP address and subnet mask
  • Default gateway
  • Primary and secondary DNS servers

Changes take effect immediately. The appliance confirms the new IP after applying.

2. Set Hostname

Section titled “2. Set Hostname”

Change the appliance’s hostname. Must follow RFC 1123 rules: letters, digits, and hyphens only, 1–63 characters, cannot start or end with a hyphen.

3. System Status

Section titled “3. System Status”

Displays:

  • Service status (running/stopped)
  • System uptime
  • Memory usage (used / total)
  • Disk usage (used / total)
  • Active WireGuard interfaces (if VPN plugin is enabled)
  • Application version

4. Restart Service

Section titled “4. Restart Service”

Restarts the VeloGuardian DNS service via systemd. DNS resolution is briefly interrupted (typically under one second) while the service restarts.

5. Show Web Interface URL

Section titled “5. Show Web Interface URL”

Detects all non-loopback network interfaces and displays the dashboard URL for each (e.g., http://192.168.1.50:8080).

6. Show Logs

Section titled “6. Show Logs”

Displays the last 50 lines of the service journal log. Useful for quickly diagnosing startup failures or DNS errors without accessing the web dashboard.

7. Reboot

Section titled “7. Reboot”

Reboots the entire VM. Prompts for confirmation before proceeding.

8. Shutdown

Section titled “8. Shutdown”

Powers off the VM. Prompts for confirmation before proceeding.

9. Shell Access

Section titled “9. Shell Access”

Drops to a bash shell for advanced administration. Use this for tasks like manual file inspection, network diagnostics (ping, dig, traceroute), or applying updates manually.

Updates via console

Section titled “Updates via console”

The web dashboard is the recommended way to apply updates, but you can also check the update status from the shell:

  1. Select option 9 to access the shell
  2. Check the service logs: journalctl -u vgdns --no-pager -n 50
  3. View the staged update directory: ls /var/lib/vgdns/updates/

For the full update workflow (check, download, apply), use the web dashboard under System Status > Updates. See the Dashboard guide for details.

Network diagnostics

Section titled “Network diagnostics”

From the shell (option 9), you can run standard network tools:

Terminal window
# Test DNS resolution through the appliance
dig example.com @127.0.0.1


# Test upstream connectivity
ping 1.1.1.1


# Check listening ports
ss -tlnp


# Watch DNS service logs in real time
journalctl -u vgdns -f

Default credentials

Section titled “Default credentials”
InterfaceUsernamePassword
Web dashboardadminadmin
ConsoleAuto-loginNo password