How to Install Umbrel OS as a VM on Proxmox VE Using Community Scripts

The Community Scripts Umbrel OS VM helper creates a Proxmox virtual machine that boots the official umbrelOS installer, giving you a straightforward path to run a personal home-cloud platform inside a Proxmox lab.

By Khurram Shahzad
Hybrid Cloud & Virtualization Engineer

•

Updated: September 28, 2026

•

8 min read

in X f ↗

What Is the Umbrel OS Community Script?

The Community Scripts project provides ready-to-run helper scripts for Proxmox VE and other supported infrastructure. Its Umbrel OS entry is categorized as a virtual machine and creates a VM that boots the official umbrelOS installer image.

The script page specifically notes that this is an installer-image workflow: after the VM is created, open its console and complete the umbrelOS installation there. This distinction matters because the helper is not simply a preinstalled Umbrel appliance image.

What You Get

Current Umbrel OS VM Requirements

Umbrel’s current virtual-machine documentation recommends a minimum of 4 GB RAM and a 32 GB virtual hard drive, with 8 GB or more RAM recommended. The VM must use EFI firmware rather than legacy BIOS.

Umbrel also recommends a bridged network adapter so the VM receives its own address on the local network. This helps umbrel.local resolve from the computer used to access the dashboard.

How to Create an Umbrel OS VM on Proxmox

Step 1 — Open the Proxmox VE Shell

Sign in to the Proxmox VE node where you want to create the Umbrel VM and open the node’s shell. The Community Scripts page provides the following command for creating a new Umbrel OS VM:

Step 2 — Create the VM

Follow the script prompts to create the VM. The current profile displayed by Community Scripts allocates 2 CPU cores, 4 GB RAM and a 32 GB disk. These values satisfy Umbrel’s current minimum VM requirements, but they may be too small for a heavily used personal cloud with media, AI or other resource-intensive applications.

Step 3 — Open the VM Console

After the helper creates the VM, open its Proxmox console. Community Scripts states that the VM boots an installer image and that the Umbrel OS installation must be completed from the console.

Step 4 — Complete the umbrelOS Installation

Umbrel’s official VM procedure is to boot the installer in EFI mode, select the virtual disk, confirm the installation, then shut the VM down and detach the installer ISO from the virtual CD drive.

Step 5 — Boot Umbrel OS

Start the VM again and give the first boot time to complete. Umbrel’s documentation says to allow about five minutes before opening http://umbrel.local.

Networking: Why Bridged Mode Matters

For a normal home-lab deployment, the Umbrel VM should have network connectivity that lets it obtain its own address on the LAN. Umbrel specifically recommends a bridged network adapter for its VM installation.

Without suitable LAN connectivity, the VM may boot successfully while umbrel.local fails to resolve from the host. In that situation, identify the VM’s assigned IP address in Proxmox or from your network infrastructure and use the IP address to reach the web interface.

Storage Planning for Umbrel

The Community Scripts profile starts with a 32 GB virtual disk, which matches Umbrel’s current minimum VM guidance. That does not mean 32 GB is sufficient for every deployment.

Umbrel is designed to host self-hosted applications and user data. Current umbrelOS includes applications for files, photos, media, AI, Bitcoin, automation and other workloads. Storage requirements can therefore grow substantially beyond the operating-system disk.

For a Lab

A 32 GB VM disk can be a reasonable starting point for evaluating Umbrel and learning the platform. Increase storage before installing applications that will retain large datasets.

For Media and Personal Cloud Workloads

Plan storage around the data rather than only the OS requirement. Media libraries, photo backups and application data can quickly exceed the initial virtual disk.

Umbrel OS 2.0: What Is New?

Current Umbrel documentation lists umbrelOS 2.0 as the latest generation. The platform now includes features such as Files, Photos, Machines, multiple household accounts, FailSafe storage, local AI capabilities and a larger application ecosystem.

Umbrel’s current site also describes running complete operating systems such as Ubuntu, Windows 11 and Android through its Machines feature. These workloads use virtualization and require hardware virtualization support for best performance.

Proxmox VM vs. Installing Umbrel Directly

Security and Maintenance Considerations

• Verify the script source: use the official Community Scripts domain and inspect the GitHub source when appropriate.
• Keep Proxmox updated: the host provides the virtualization layer for the Umbrel VM.
• Keep umbrelOS updated: use Umbrel’s normal update mechanism and official documentation.
• Protect the management plane: avoid exposing Proxmox or Umbrel administrative interfaces directly to the public Internet without an appropriate security architecture.
• Back up important data: a VM snapshot is not automatically a complete application-consistent backup of every Umbrel workload.
• Plan storage: self-hosted applications can consume considerably more storage than the initial 32 GB OS disk.

Community Scripts Update in September 2026

The Community Scripts Umbrel OS VM page records its latest change as September 27, 2026, linked to pull request #17505. The change was a refactor intended to improve the structure and readability of the Umbrel OS VM script, including function calls and variable handling.

This is useful context for administrators following the script itself: the helper is actively maintained even though the page’s displayed upstream Umbrel release information is much older. The Community Scripts page separately warns that the upstream release shown in its release section may differ from the version the script actually installs.

Who Should Use This Proxmox Umbrel VM?

• Home-lab users who already operate a Proxmox VE server.
• Administrators evaluating Umbrel before dedicating physical hardware to it.
• Self-hosting enthusiasts who want Umbrel alongside other Proxmox workloads.
• IT learners building a personal-cloud and virtualization lab.
• Users who want to test Umbrel applications without replacing an existing physical operating system.

Final Takeaway

The Community Scripts Umbrel OS VM provides a convenient Proxmox VE starting point: it creates the VM, boots the official umbrelOS installer and leaves the final OS installation to the administrator through the VM console.

The most important technical details are straightforward—4 GB RAM and 32 GB storage meet Umbrel’s current VM minimums, EFI firmware is required, and bridged networking is recommended. For real workloads, allocate additional CPU, memory and storage according to the applications and data you intend to run.

Sources & References

Khurram Shahzad — Hybrid Cloud & Virtualization Engineer

Hybrid Cloud & Virtualization Engineer specializing in VMware, Azure, AWS, Windows Server, Microsoft 365, Linux, networking, backup & disaster recovery. I share practical guides, technical projects and insights into modern IT infrastructure through VMoreCloud.