Skip to content

Linux Agent Operations

DroidVM can perform offline maintenance operations on Linux disk images without booting the full system. It works by launching a temporary minimal VM, mounting the target disk and running a script, then automatically destroying the VM when done.

Currently the main feature provided is offline password reset.

Agent Operations

📷 Screenshot placeholder: Agent operation progress terminal

Offline Password Reset

When you forget the password of the Linux system inside the VM, or the default password of an imported image is unknown, you can use this feature to change it directly.

Steps

  1. Find the target disk in the Disks tab
  2. Open the disk operations menu and select Reset Password
  3. Fill in the form:
FieldMeaning
DiskTarget disk (shown in the title)
New PasswordRequired
Confirm PasswordMust match the new password
Also reset regular user passwordToggle, off by default. When enabled, the regular user's password is changed as well
  1. After confirming, DroidVM launches a temporary VM to perform the operation, with progress shown live in the terminal
  2. On success, a "Password changed successfully" message is shown

Reset Password

📷 Screenshot placeholder: Password reset form

Scope

This operation mounts the disk's root partition and modifies the password database within it. It applies to standard Linux filesystem images. It may not be able to handle encrypted disks or unconventional partition layouts.

Stop the VM before proceeding

Make sure the target disk is not in use by a running VM, otherwise data corruption may occur. The progress screen can be cancelled at any time; cancelling stops and deletes the temporary VM.

Released under the GNU GPL v3.0 License