Browse documentation

Install on your hardware

Create a bootable USB stick and start a real computer with DurgX.

Important

Writing the image erases everything on the USB stick. Double-check the device before you write. DurgX is alpha software: use a spare machine, or one whose data is backed up.

What you need

  • A 64-bit x86 computer (Intel or AMD) that can boot from USB. Both UEFI and older BIOS firmware are supported by the same image.
  • A USB stick of 1 GB or more.
  • The durgx.iso file.

Step 1: write the image to the USB stick

Windows (Rufus)

  1. Install Rufus and open it.
  2. Pick your USB stick under Device.
  3. Click SELECT and choose durgx.iso.
  4. Set Partition scheme to GPT for UEFI computers, or MBR for older BIOS computers.
  5. Click START. If Rufus asks, choose Write in DD Image mode.

Linux (dd)

terminal
# 1. Find your USB stick. Check the name carefully.
lsblk -o NAME,SIZE,MODEL,TRAN

# 2. Write the image. Replace /dev/sdX with your stick.
sudo dd if=durgx.iso of=/dev/sdX bs=4M status=progress conv=fsync
sync

macOS (dd)

terminal
diskutil list
diskutil unmountDisk /dev/diskN
sudo dd if=durgx.iso of=/dev/rdiskN bs=4m
diskutil eject /dev/diskN

Step 2: boot from the USB stick

  1. Plug the stick into the target computer and restart it.
  2. Open the boot menu. The key depends on the maker: usually F12, F10, Esc or Del.
  3. Choose the USB stick. On a UEFI computer pick the entry that starts with "UEFI".
  4. If the computer refuses to boot it, turn Secure Boot off in the firmware settings. The v0.1-alpha image is unsigned.

Step 3: check that it worked

DurgX v0.1-alpha prints its boot messages on the serial console. To see them on a real machine you need a serial connection to another computer. If you only see a blank or static screen, that is expected. Use a virtual machine first if you want to read the log.

Going back to normal

Turn the computer off, unplug the stick and start it again. Your usual system starts as before.

Note

Need help with a specific machine? Email [email protected] with the model name and what you see.