Skip to content

Install umbrelOS on x86 systems

Jump to bottom
Mayank Chhabra edited this page Apr 29, 2024 · 10 revisions

Note

umbrelOS is specifically built for Umbrel Home. Support for other devices is best-effort and not guaranteed. Compatibility issues may arise due to the differences in hardware, drivers, and such.

Minimum System Requirements

  • CPU: Dual-core 64-bit Intel or AMD processor. (Quad-core or higher recommended)
  • RAM: 4GB. (8GB+ recommended)
  • Storage: 32GB. (Storage needs depend on your use case. For instance, running a Bitcoin node typically requires 1TB or more, while file/media storage needs can be estimated based on your cloud services usage.)

How to install

Step 1: Prepare a bootable USB stick

  • Download umbrelOS 1.1.1 USB installer umbrelos-amd64-usb-installer.img.xz on your computer.
  • Download and install Balena Etcher on your computer.
  • Plug a USB stick (at least 4GB) into your computer. Ensure that it doesn't contain any important data as it will be formatted.
  • Use Balena Etcher to flash the umbrelos-amd64-usb-installer.img.xz file to the USB stick.

Step 2: Boot from USB stick

  • Remove the USB stick from your computer, and insert it into your device.
  • Connect a display and keyboard to your device (for desktops or NUCs/Mini PCs).
  • Plug an Ethernet cable into your device and connect it to your internet router.
  • Turn on the device. It should automatically boot from the USB stick.

If your device doesn't automatically boot from the USB stick, you might need to change the boot priority order in your its BIOS settings.

Step 3: Install umbrelOS on internal storage

  • After the system boots up, it will present you with the following screen:
  • Identify the correct internal storage device where you intend to install umbrelOS, and note its corresponding number. For instance, in the above screenshot, if we want to install it on the 'ATA' drive, which has a capacity of '238.5G', we'd type '1' (without the quotes) and press Enter.

Step 4: Finalize installation

  • After the flashing process is complete, turn off the device by pressing any key.
  • Remove the USB stick, keyboard, and display.

Step 5: Boot up!

  • Important: Ensure that the USB stick is no longer connected to the device. Also, double-check that the Ethernet cable is connected between your device and the router.

  • Turn on your device.

  • The first boot will take ~5 minutes. After booting up, you can access umbrelOS by navigating to http://umbrel.local on any device connected to the same network.

Tip

If you cannot access http://umbrel.local, and you are using a Windows computer, try accessing http://umbrel. Alternatively, use your router's admin dashboard or a network scanning tool like 'Fing' to find your device's IP address on your local network. If needed, you can connect a display and a keyboard to your device, log in, and run hostname -I to find its IP address. Then, enter this IP address directly into a web browser to access umbrelOS.

Support

To get support or share your experience with others, please join our community forum and Discord server.

Clone this wiki locally