Skip to main content

​
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.

Difficulty

Beginner

Time

2 Minutes

​
Before You Start: Two Requirements

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

Your Server Must Be Running

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.

The QEMU Guest Agent Must Be Installed and Running

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.

​
Resetting the Password

1

Navigate to Your Server

Log into the VPS Control Panel at cloud.freakhosting.com. Click on Servers in the top navigation bar, then click Manage next to the server whose password you need to reset.
2

Open the Options Tab

Click on the Options tab in the server management navigation.
3

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.”
4

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.
5

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.
6

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
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 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: 
# 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 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:
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
  1. Exit Rescue Mode and boot normally — you can now log in with the password you just set
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.
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.
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 are completely separate.
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.
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.

​
Need Extra Help?

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

​
Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!
Last Updated: March 2026 | VPS Support: Password reset simplified.