Skip to content

Web Dashboard

The Web Dashboard lets you monitor and control your virtual machines from any browser on your local network ā€” no VirtualProg app window required. Access it from another Mac, iPad, or any device connected to the same network.

šŸ”§ Enabling the Dashboard

Before using the Web Dashboard, enable the CLI Server in VirtualProg:

  1. Open VirtualProg ā†’ Settings ā†’ CLI
  2. Enable CLI Server
  3. Enable External Access to allow connections from other devices on your network
  4. Note your token ā€” you will need it to log in

šŸŒ Accessing the Dashboard

Open a browser and navigate to:

http://<your-mac-ip>:<port>/dashboard

To find your Mac's IP address, go to Settings ā†’ CLI ā€” the full address is shown there.

If you are accessing from the same Mac:

http://127.0.0.1:<port>/dashboard

šŸ” Login

On first visit, you are prompted for your token. Enter the token from Settings ā†’ CLI and click Sign In.

The token is saved in your browser ā€” you will not need to enter it again unless you sign out or clear your browser data.

šŸ–„ļø Virtual Machines

The Virtual Machines tab is the default view. It shows all your VMs as cards.

Web Dashboard - Virtual Machines

Summary Bar

At the top, four summary tiles show the total count of VMs in each state at a glance:

  • Total ā€” all VMs
  • Running ā€” currently active
  • Stopped ā€” powered off
  • Paused / Suspended ā€” frozen or saved to disk

Search, Filter & Sort

Above the VM grid, a toolbar lets you narrow down the list:

  • Search ā€” type any part of a VM name to filter cards instantly
  • State pills ā€” click All, Running, Stopped, or Paused to show only VMs in that state
  • Sort ā€” choose Name Aā€“Z, Name Zā€“A, or By State

Filters and sorting are preserved during auto-refresh.

VM Cards

Each card shows the VM name, OS/distro, current state, CPU, and memory. Action buttons are shown directly on the card and update based on the VM state:

State Available Actions
Stopped ā–¶ Start, šŸ—‘ Delete
Running ā–  Shutdown, ā» Stop, āø Pause, ā†ŗ Restart, šŸ’¾ Suspend
Paused / Suspended ā–¶ Resume

VM Detail Panel

Click any VM card to open the detail panel on the right. It shows full configuration and hardware details, uptime statistics, and snapshot management.

From the detail panel you can also:

Action Description
šŸ“¦ Create Template Save a stopped VM as a reusable template
šŸ§¬ Clone Duplicate a stopped VM under a new name
āœļø Rename Rename the VM ā€” enter the new name in the dialog

Snapshots

The detail panel includes a Snapshots section. You can:

  • View all existing snapshots
  • Create a new snapshot by entering a name and clicking + Create
  • Restore or delete any snapshot

Auto-Refresh

The Virtual Machines tab refreshes automatically every 10 seconds. Use the ā†ŗ Refresh button in the header to refresh immediately.

šŸ“¦ Templates

The Templates tab shows all your saved VM templates as cards.

Web Dashboard - Templates

Each card shows the template name, OS/distro, CPU, memory, and creation date.

Use the search bar to filter templates by name, or the sort dropdown to order by Name Aā€“Z, Name Zā€“A, Newest first, or Oldest first.

Click a template card to open the detail panel, which shows the full template configuration including source VM, OS, and hardware specs.

Template Actions

Action Description
+ Create VM Create a new virtual machine from this template
šŸ—‘ Delete Permanently delete the template

šŸŒ Networks

The Networks tab shows all custom networks configured in VirtualProg.

Web Dashboard - Networks

Each card shows the network name, type, enabled/disabled status, subnet, and MTU.

Use the search bar to filter networks by name, or the sort dropdown to order by Name Aā€“Z, Name Zā€“A, By Type, or By Status.

Click a card to open the detail panel showing the full network configuration including subnet, mask, MTU, IPv6, and IPv6 prefix.

Networks are read-only in the dashboard. To create or modify networks, use the VirtualProg app.

šŸŒ™ Dark & Light Theme

The dashboard follows your device's appearance setting by default. Use the šŸŒ™ / ā˜€ļø button in the header to switch between dark and light themes manually. Your preference is saved and remembered across sessions.

šŸ”’ Sign Out

Click Sign out in the top-right corner to end your session. Your token is cleared from the browser.