> For the complete documentation index, see [llms.txt](https://en.itmatic101.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en.itmatic101.com/virtualisation/proxmox-offline-mirror-pom-for-offline-updates.md).

# Proxmox Offline Mirror (POM) for offline updates

Keeping Proxmox VE systems up to date is straightforward when Internet access is available. However, in air-gapped or highly restricted environments, administrators need an alternative method to distribute updates securely and consistently. This article demonstrates how to build an offline update infrastructure using Proxmox Offline Mirror (POM). The solution allows a dedicated mirror server with Internet access to download and maintain Proxmox and Debian repositories, while isolated Proxmox nodes consume updates from a locally hosted mirror.

The environment consists of the following components:

* Mirror Server - downloads and synchronizes Proxmox and Debian repositories from the Internet
* Storage - dedicated 400 GB disk used to store repository snapshots
* NGINX web server - publishes mirrored repositories to offline systems
* Proxmox VE nodes - air-gapped systems that consume updates through HTTP

The overall workflow is:

1. Download repository content on the mirror server.
2. Create repository snapshots using Proxmox Offline Mirror.
3. Synchronize snapshots to an update medium.
4. Host the mirrored APT repositories on NGINX web server via HTTP.
5. Configure the web address URL as APT sources on offline Proxmox nodes.
6. Perform normal package upgrades without Internet access.