---
title: "How to Update Proxmox Manually"
url: "https://edywerder.ch/how-to-update-proxmox/"
type: "post"
published: "2026-05-20T18:21:29+02:00"
modified: "2026-05-21T13:24:33+02:00"
author: "Edy Werder"
---

Knowing how to update Proxmox manually keeps you in control of when patches and kernel updates hit your server. This guide covers both the command-line and the web GUI approaches.

 ![How to update Proxmox manually — hero image showing the Proxmox logo, a terminal window, and a server rack."](https://edywerder.ch/wp-content/uploads/How-to-update-Proxmox-1680x945-px-Blog-Banner-scaled.webp)

---

**Quick Answer: To update Proxmox manually, run these three commands via SSH or the shell:**

```
apt update
apt list --upgradable
apt dist-upgrade
```

If the upgrade output includes a package containing `pve-kernel-*` or `proxmox-kernel-*`, reboot. Your VMs keep running throughout the update and only a reboot interrupts them

I update manually, and only when Proxmox announces a new version or a significant security fix. Here’s exactly how I do it.

---

---

## How to Update Proxmox via the Command Line

Connect via SSH or open a shell on your node, then run these three commands in order.

### Step 1 — Refresh the package list

```
apt update
```

This checks the repositories for what’s available. Nothing gets installed yet. If you see a 401 Unauthorized error, as shown in the screenshot below, the [enterprise repository](https://pve.proxmox.com/wiki/Package_Repositories) is active without a subscription key. Run this to disable it:

 ![Proxmox shell output showing a 401 Unauthorized error on apt update caused by the enterprise repository being active without a subscription key](https://edywerder.ch/wp-content/uploads/Proxmox-update-401-error.webp)

To fix it, go to your node → **Updates** → **Repositories**, select the enterprise repository and click **Disable**, then run `apt update` again.

### Step 2 — Check what’s waiting

```
apt list --upgradable
```

This shows every package with a pending update. Scan the list before committing. It tells you whether a kernel package is included. Look for names like `proxmox-kernel-*` or `pve-kernel-*`. If you see those, a reboot will be needed after the upgrade.

### Step 3 — Apply the updates

```
apt dist-upgrade
```

Proxmox recommends `dist-upgrade` over plain `apt upgrade`. The reason matters: when multiple Proxmox packages update together, plain `apt upgrade` can hold some back due to dependency changes. `dist-upgrade` handles those correctly.

---

---

## How to Update Proxmox via the Web GUI

If you prefer not to use the command line, the web GUI produces the same result.

Go to your node → **Updates** → click **Refresh**. Review the list, then click **Upgrade**. A console window opens and runs the equivalent of `apt dist-upgrade`.

 ![Proxmox web GUI Updates panel showing 126 available Debian packages with current and new version numbers listed.](https://edywerder.ch/wp-content/uploads/Proxmox-update-gui.webp)

If you see a 401 Unauthorized error, as shown in the screenshot below, the enterprise repository is active without a subscription key. Go to **Repositories**, disable the enterprise repo, add the no-subscription repo, then click **Refresh** again.

 ![Proxmox web GUI task viewer showing a 401 Unauthorized error when updating the package database due to an active enterprise repository without a subscription key](https://edywerder.ch/wp-content/uploads/How-to-update-Proxmox-step-1.webp)

I use the command line because it’s faster and I can see exactly what’s happening — but either method works.

---

**Curious what hardware I run Proxmox on?**

I created an Amazon storefront with all the gear I use and recommend.

  [Visit my Amazon Storefront](https://www.amazon.com/shop/edyus/list/1YOVY1DPQY53A?ref_=aip_sf_list_spv_ofs_mixed_d)

---

## Do Your VMs Keep Running During an Update?

Yes. Running `apt dist-upgrade` does not interrupt your virtual machines or containers. They stay running throughout the entire update process. The only thing that interrupts them is a reboot and a reboot is only needed when a kernel package was part of the update.

This is one of those things nobody seems to state clearly, so update freely without shutting down your VMs first.

---

---

## Do You Need to Reboot After Updating?

Proxmox does not display a reboot required message after an update. To make this check easier, I wrote a small bash script that compares the latest installed kernel against the currently running one and tells you clearly whether a reboot is needed.

The script is available on [GitHub](https://github.com/EdyWerder/proxmox-scripts/tree/main/kernel-check). Read the README before running it on your node.

If you are comfortable with bash scripts, install it directly on your Proxmox node:

```
wget -O /usr/local/bin/proxmox-kernel-check.sh https://raw.githubusercontent.com/EdyWerder/proxmox-scripts/main/kernel-check/proxmox-kernel-check.sh && chmod +x /usr/local/bin/proxmox-kernel-check.sh
```

Then run it:

```
proxmox-kernel-check.sh
```

If the kernels match, no reboot is needed.

 ![Proxmox kernel check script output showing latest installed kernel and running kernel match on Proxmox 9.1.1 with no reboot needed](https://edywerder.ch/wp-content/uploads/Proxmox-Kernel-check-no-reboot.webp)

If the latest installed kernel differs from the running kernel, a reboot is recommended.

 ![Proxmox kernel check script output showing kernel mismatch between linux-image-6.17.13-11-pve and linux-image-6.17.2-1-pve with reboot recommended.](https://edywerder.ch/wp-content/uploads/Proxmox-Kernel-check-reboot-required.webp)

When you are ready to reboot, run:

bash

```
reboot
```

---

---

## How Often Should You Update?

That depends on your setup. In my homelab, I update when Proxmox announces a new version, not for every individual kernel patch. The tradeoff is that some interim updates contain security fixes. If your server is internet-facing or exposed beyond your local network, staying closer to current makes sense.

For a homelab behind a firewall with no direct external exposure, the practical risk of waiting is low. The bigger risk is applying an update without checking what’s in it first — which is why I always run `apt list --upgradable` before committing.

Before running any update, make sure you have a current backup. If you haven’t set up [Proxmox Backup Server](https://edywerder.ch/proxmox-backup-server/) yet, this guide walks you through it.

---

### Related Articles

- [How to Install Proxmox Server](https://edywerder.ch/install-proxmox-server/)
- [Proxmox Backup Server: What It Does and How to Set It Up](https://edywerder.ch/proxmox-backup-server/)

I’d love to hear from you. Was this article helpful? Share your thoughts in the comments below. If you prefer, you can also reach me [by email](mailto:info@edywerder.ch) or connect with me on Reddit at [Navigatetech](https://www.reddit.com/r/NavigateTech/).

---

## Full Disclosure

Any purchases made from clicks on links to products on this page may result in an affiliate commission for me. 

Please keep in mind that the quantity or price of items can change at any time.

As an Amazon  Associate, I earn from qualifying purchases.

Als Amazon-Partner verdiene ich an qualifizierten Verkäufen

As an eBay Partner, I earn from qualifying purchases.

Als eBay-Partner verdiene ich an qualifizierten Verkäufen.
