Skip to content

Resource Management ​

Resource Management lists every VM and LXC container on the platform: personal, shared, class, course lab and quick practice machines, across all PVE connections. From here an administrator can power machines on and off, open a console, convert a machine to a template, delete machines one by one or in bulk, and open any machine's detail page. Sidebar: Resources → Resource Management. Path: /resource-mgmt.

Who can use it ​

Administrators only. The sidebar item is hidden for teachers and students, and the page and the list it loads are refused for anyone who is not an administrator.

Before you start ​

  • At least one PVE connection must be configured (see PVE Management). Without one the list is empty.
  • The list refreshes automatically in the background; you do not need to reload the page after acting on a machine.

Step by step ​

Find a machine ​

  1. Use the status switch above the table: All, Running or Stopped. The badge on each option counts all machines and ignores the search.
  2. Type in the search box (Search name, VMID, IP or owner). Separate several words with spaces: every word must match. For example, an owner's name followed by the start of an IP address narrows the list to that owner's machine on that subnet. The owner's email also matches.
  3. If nothing matches, the page shows No machines match the filters. Click the button under it to clear the search or the status filter.

Find a machine (numbers match the steps above)

Read the table ​

Each row shows:

  1. Name, with the machine type (Virtual Machine (VM) or Container (LXC)) and its VMID underneath.
  2. Source: whether the machine is personal, shared, a class machine, a course lab machine or a quick practice machine, together with its owner.
  3. Environment / OS.
  4. Status (see the table below).
  5. IP Address. If the machine has services published by URL, the URLs are listed under the IP as links that open in a new tab.
  6. Expiry Date. The small text under the date is the actual cutoff converted to your local time. ∞ No expiry means no expiry date is set.
  7. Node: the PVE node the machine runs on.
  8. Actions: console and power menu, shown only while the machine is in a state that can be controlled; otherwise the column repeats the status.

Read the table (numbers match the steps above)

Work with course and quick practice environments ​

Machines that belong to a course teaching environment or a quick practice environment are grouped under one group row.

  1. Click the group row (or the arrow at its left) to expand or collapse it. The second line of the group shows how many machines it has, or how many match your search (for example "2 of 5 machines match").
  2. The Status column of the group shows how many machines are running, for example "3/5 running".
  3. To power the whole group, click ⋮ on the group row (Group power) and choose Start all or Shut down all. Start all is disabled when every machine is already running; Shut down all is disabled when none is running.
  4. Each machine inside the group has its own Console / Terminal button and ⋮ power menu. Machines in a group show Managed as part of the environment in the expiry column and cannot be deleted one by one.

Work with course and quick practice environments (numbers match the steps above)

Open a machine's console ​

  1. Make sure the machine is Running.
  2. Click Console (VM) or Terminal (LXC) in the Actions column. The console opens in a dialog.
  3. While the machine is Starting, the button stays disabled until boot finishes.

Open a machine's console (numbers match the steps above)

Power a single machine on or off ​

  1. Click ⋮ (Power Control) at the end of the row.
  2. Choose Start, Shutdown, Reboot, Force stop or Force reset. Only the actions that fit the current state are enabled:
    • Start needs a stopped or paused machine.
    • Shutdown, Reboot and Force reset need a running machine.
    • Force stop works on a running machine and also on one that is still Starting (a way out when boot hangs).
  3. A message confirms that the command was sent, and the status updates in place.

Power a single machine on or off (numbers match the steps above)

Act on several machines at once ​

  1. Tick the checkbox at the start of each row, or tick the header checkbox to select every machine currently shown. Hold Shift while clicking to select a range. Once at least one machine is ticked, clicking a row ticks it instead of opening the detail page.
  2. The toolbar turns into a batch bar showing how many machines are selected.
  3. Click Start or Shutdown, or open More for Reboot, Force Stop and Force Reset. Delete sits on the far right.
  4. Each action is sent only to the machines it applies to (for example, Shutdown only to running ones). Hover over a button to see how many will be skipped; a button is disabled when none of the selected machines can do it.
  5. Force Stop, Force Reset and Delete ask for confirmation first. The delete dialog lists up to five machine names and "and N more".
  6. A progress line shows how far the batch has got. When it finishes, a message reports how many succeeded and how many were skipped. Machines that failed stay selected so you can retry.
  7. Click × next to the count (Clear selection), or press Esc, to leave the batch bar.

Act on several machines at once (numbers match the steps above)

Delete a machine ​

  1. Click ⋮ on the row and choose Delete.
  2. Confirm in Delete this resource?. The machine and all its data cannot be recovered.
  3. A deletion request is queued and the row disappears from the list. The deletion itself runs as a background job (see Background Jobs).

Delete a machine (numbers match the steps above)

Convert a machine to a template ​

  1. Click ⋮ on the row and choose Convert to template. This option does not appear for class machines, for placeholder rows of requests still being provisioned, or inside environment groups.
  2. The template form opens with this machine preselected and locked as the source and its name prefilled. Fill in the rest of the form (see Templates).
  3. After you save, the machine leaves this list and you are taken to the Templates page.

Convert a machine to a template (numbers match the steps above)

Open a machine's detail page ​

  1. Click anywhere on a machine row other than its buttons and checkbox. Machines inside an environment group open the same way.
  2. The detail page opens at /resource-mgmt/<vmid> with the same tabs the owner sees (Overview, Monitoring, Specifications, Snapshots or Backups depending on whether the machine supports snapshots, Audit Log, Advanced Settings). See Resource Detail for each tab.
  3. Back to list returns to Resource Management.

What is different for an administrator on the detail page:

  • You can act on machines you do not own.
  • Specifications: the new CPU, memory and disk are applied directly with Apply Changes. There is no request to submit, no reason to write and no quota cap. A running VM needs a reboot before CPU and memory changes take effect, and the disk can only grow.
  • Snapshots: you can delete evidence snapshots (marked Evidence) that the platform takes automatically when it detects suspected mining. Owners cannot delete them.

Open a machine's detail page (numbers match the steps above)

Create a machine ​

  1. Click Create Resource at the top right.
  2. You are taken to the request form on My Requests, where you fill in specs and a usage window the same way other users do. This page does not create machines by itself.

Create a machine (numbers match the steps above)

Fields and options ​

FieldMeaningNotes
Status: Scheduled / ProvisioningAn approved request whose machine is not created yet, or is being createdShown as a placeholder row; cannot be selected or controlled
Status: StartingThe boot task is still runningConsole disabled; only Force stop available
Status: Running / Stopped / PausedCurrent power state from PVEDecides which power actions are enabled
Status: Creation FailedProvisioning failedNo power actions
Status: Unknown StatusState could not be read
SourcePersonal, shared, class, course lab or quick practice, with the ownerGroup rows show the class or environment instead
Expiry DateLast day of use; small text is the cutoff in local time∞ No expiry when none is set
SearchMatches name, VMID, IP, owner name and owner emailAll space-separated words must match; group names match too

Limits and behaviour to know ​

  • Machines that are being deleted, and placeholder rows for requests that are still being provisioned, have no checkbox and no power menu.
  • Force stop and force reset cut power without a clean shutdown; unsaved data in the guest may be lost.
  • Deleting removes the machine from PVE and cannot be undone. Machines in a course or quick practice environment cannot be deleted from here one by one; the environment manages them as a group.
  • Selection only covers machines currently shown. Machines that disappear (filtered out or removed by a refresh) are unticked automatically.

Released under the AGPL-3.0 License.