> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Reset Your VPS Root or Administrator Password

> Reset the root or administrator password on your FREAKHOSTING VPS from the control panel when locked out or rotating credentials for security purposes.

## Regaining Access When You Forget Your Password

It happens to everyone. You set up your server weeks ago, stored the password somewhere safe, and now you cannot find it. Or maybe you changed the password and cannot remember what you changed it to. The good news is that the FREAKHOSTING VPS Control Panel has a built-in password reset feature that lets you set a new root (Linux) or Administrator (Windows) password in about 30 seconds — without needing to log into the server first.

There is one important catch: this feature depends on a small service called the **QEMU Guest Agent** running inside your server. We will explain exactly what that means, how to check if you have it, and what to do if you do not.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Beginner
  </Card>

  <Card title="Time" icon="clock">
    2 Minutes
  </Card>
</CardGroup>

***

## Before You Start: Two Requirements

The password reset feature needs two things to work. If either of these is missing, the reset will fail:

<CardGroup cols={1}>
  <Card title="Your Server Must Be Running" icon="circle-check">
    The password reset communicates with your server in real time — it sends the new password to the operating system while it is running. If your server is powered off, the message has nowhere to go. **Boot your server first** using the **Boot** button on the Overview page, wait for it to fully start up, then come back and reset the password.
  </Card>

  <Card title="The QEMU Guest Agent Must Be Installed and Running" icon="microchip">
    The **QEMU Guest Agent** is a tiny background service that acts as a communication channel between the hosting platform and the operating system inside your VPS. When you click "Reset Password," the control panel sends the new password through this channel, and the agent applies it inside the OS.

    **If you built your server using one of FREAKHOSTING's standard OS templates**, the QEMU Guest Agent is already installed and running. You do not need to do anything.

    **If you installed a custom operating system from an ISO**, or if you removed or disabled the agent, the password reset will fail. See the troubleshooting section below for how to fix this.
  </Card>
</CardGroup>

***

## Resetting the Password

<Steps>
  <Step title="Navigate to Your Server">
    Log into the VPS Control Panel at [cloud.freakhosting.com](https://cloud.freakhosting.com). Click on **Servers** in the top navigation bar, then click **Manage** next to the server whose password you need to reset.
  </Step>

  <Step title="Open the Options Tab">
    Click on the **Options** tab in the server management navigation.
  </Step>

  <Step title="Select the Password Sub-Tab">
    Click on the **Password** sub-tab. You will see the message: "Set a new root or administrator password. If you removed or don't have the QEMU guest agent installed on your server, this operation will fail. The server must be running to perform this action."
  </Step>

  <Step title="Click Reset Password">
    Click the blue **Reset Password** button. The system will generate a new, strong, random password and push it to your server's operating system through the QEMU Guest Agent.
  </Step>

  <Step title="Save the New Password Immediately">
    The new password will be displayed on screen. **Copy it right now** and store it in a secure location — a password manager is ideal. This is the only time the password is shown, and you will need it to log in.
  </Step>

  <Step title="Log In with Your New Password">
    Use the new password to connect to your server:

    * **Linux:** Connect via SSH — `ssh root@your-server-ip`
    * **Windows:** Connect via Remote Desktop (RDP) using the Administrator account
  </Step>
</Steps>

***

## After Resetting: Recommended Next Steps

Once you are back inside your server, take a few minutes to secure your access for the future:

* **Set a memorable but strong password** — The auto-generated password is random and hard to remember. Log in and change it to something you can recall: `passwd` on Linux, or use Computer Management on Windows.
* **Update saved credentials everywhere** — If you have the server password saved in SSH clients (PuTTY, Termius), deployment scripts, cron jobs, or configuration management tools, update them with the new password.
* **Switch to SSH key authentication (Linux)** — This is the single best thing you can do. SSH keys eliminate password-based login entirely, which means you cannot be locked out by a forgotten password and your server is more secure against brute-force attacks. See [How to Manage SSH Keys](/portals/vps-panel/how-to-manage-ssh-keys) for a step-by-step guide.

***

## What If the Password Reset Fails?

If you click **Reset Password** and get an error, the problem is almost always the QEMU Guest Agent. Here is a decision tree to get you back on track:

### Step 1: Check if the Server is Running

Go to the **Overview** page for your server. If the status shows anything other than **Running**, boot the server first and wait for it to fully start.

### Step 2: Can You Access the Server Through VNC?

If you have any way to get into the server (even though you forgot the password — maybe you have SSH keys set up, or another user account), you can check and install the QEMU Guest Agent manually:

```bash theme={null}
# Check if the QEMU Guest Agent is running
systemctl status qemu-guest-agent

# If it is not installed, install it:

# Debian / Ubuntu
apt update && apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

# CentOS / AlmaLinux / Rocky Linux
yum install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

# Verify it is running
systemctl status qemu-guest-agent
```

After confirming the agent is running, go back to the control panel and try the password reset again.

### Step 3: Use Rescue Mode as a Last Resort

If you cannot log into the server at all (no password, no SSH keys, no VNC access), you can use [Rescue Mode](/portals/vps-panel/how-to-use-rescue-mode) to reset the password manually:

1. Boot into Rescue Mode from **Options** > **Rescue**
2. Mount your server's disk and chroot into it
3. Reset the password from inside the chroot:

```bash theme={null}
mount /dev/vda1 /mnt
mount --bind /dev /mnt/dev
mount --bind /proc /mnt/proc
mount --bind /sys /mnt/sys
chroot /mnt

# Set a new root password
passwd root

# Also install the QEMU Guest Agent while you are here
apt update && apt install -y qemu-guest-agent
systemctl enable qemu-guest-agent

exit
umount /mnt/sys /mnt/proc /mnt/dev /mnt
```

4. Exit Rescue Mode and boot normally — you can now log in with the password you just set

***

<AccordionGroup>
  <Accordion title="What if the password reset says it succeeded but the new password does not work?">
    This can happen if the QEMU Guest Agent is installed but not functioning correctly. Try rebooting the server from the control panel (Power Controls > Restart), wait for it to fully boot, and try the password reset again. If it still does not work, use VNC to log in and check that the agent is running: `systemctl status qemu-guest-agent`.
  </Accordion>

  <Accordion title="Can I reset the password if my server is powered off?">
    No. The password reset requires the server to be running because it uses the QEMU Guest Agent to communicate the new password to the operating system in real time. The agent can only receive the new password while the OS is booted and the agent service is active. Boot your server first, then perform the reset.
  </Accordion>

  <Accordion title="Does this reset my VPS Control Panel password?">
    No. This feature resets the **operating system** root/administrator password — the one you use to SSH into your Linux server or RDP into your Windows server. Your control panel login credentials at [cloud.freakhosting.com](https://cloud.freakhosting.com) are completely separate.
  </Accordion>

  <Accordion title="What exactly is the QEMU Guest Agent?">
    The QEMU Guest Agent is a small, lightweight service that runs inside your VPS and provides a communication channel between the hosting platform (the hypervisor) and your server's operating system. It enables several features: password resets, clean shutdown signaling (so the host can tell the OS to shut down gracefully), and filesystem freezing for consistent backups. It uses very minimal resources and has no impact on your server's performance.
  </Accordion>

  <Accordion title="Does this work on Windows servers?">
    Yes. The password reset feature works on both Linux and Windows servers. On Windows, it resets the **Administrator** account password. The same QEMU Guest Agent requirement applies — FREAKHOSTING's Windows templates include the agent pre-installed.
  </Accordion>
</AccordionGroup>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** March 2026 | **VPS Support:** Password reset simplified.
</div>