Installing devicefreedom-os in a virtual machine

devicefreedom-os is designed for DeviceFreedom Tab and DeviceFreedom Phone, but you can also run it in a virtual machine using any virtualization software that supports EFI boot — such as Proxmox, VirtualBox, or VMware. Some features are unavailable on DIY hardware — see DeviceFreedom Tab & Pro vs. DIY for details.

Minimum VM requirements

• RAM: 4 GB (8 GB+ recommended)
• Storage: 32 GB virtual hard drive (more depending on your use case)

Install devicefreedom-os

1. Download the latest devicefreedom-os USB installer ISO.
2. Create a new VM and allocate at least 4 GB of RAM and a 32 GB virtual hard drive.
3. Attach the ISO to the VM's virtual CD-ROM drive.
4. Important: Set the VM to boot in EFI mode, not legacy BIOS. The installer requires EFI mode.
5. Boot the VM. The installer will show a drive selection screen — select your virtual hard drive and confirm.
6. Once installation is complete, shut down the VM.
7. Remove the installer ISO from the VM's virtual drives.

Boot and access

1. Boot the VM.
2. Wait about 5 minutes for the first boot to complete, then open http://devicefreedom.local in your browser.

See Connecting to your DeviceFreedom if you need help accessing it.

Notes

• You may see a terminal login prompt on the VM's console — this is for terminal access only. Use the web interface at http://devicefreedom.local instead.
• If your VM doesn't have a bridged network adapter, http://devicefreedom.local may not resolve from your host machine. Make sure your VM's network is set to bridged mode so it gets its own IP on your local network.