# HP ProDesk UEFI Boot - Complete Guide

## ✅ New ISO Created with UEFI Support

**Location**: `/Users/dorian/Projects/archy/image-recipe/results/archipelago-3.19-hp-prodesk-uefi-x86_64.iso`

**Size**: 278MB

**Boot Support**:
- ✅ UEFI (modern firmware)
- ✅ Legacy BIOS (older systems)
- ✅ Hybrid bootable (works on both)

## Verified UEFI Boot Files

The ISO contains:
- `/efi/boot/bootx64.efi` - UEFI bootloader (688KB)
- `/boot/grub/efi.img` - GRUB EFI image (1.4MB)
- `/boot/grub/grub.cfg` - GRUB configuration
- `/boot/syslinux/` - Legacy BIOS boot

## How to Flash to USB

### Method 1: Balena Etcher (Recommended)
1. Launch Balena Etcher
2. Select ISO: `archipelago-3.19-hp-prodesk-uefi-x86_64.iso`
3. Select your USB drive
4. Click "Flash!"

### Method 2: Terminal (dd)
```bash
# Find USB
diskutil list

# Unmount (replace diskN with your USB)
diskutil unmountDisk /dev/diskN

# Flash
sudo dd if=/Users/dorian/Projects/archy/image-recipe/results/archipelago-3.19-hp-prodesk-uefi-x86_64.iso of=/dev/rdiskN bs=1m status=progress

# Eject
diskutil eject /dev/diskN
```

## How to Boot HP ProDesk in UEFI Mode

### Step 1: Insert USB and Power On

### Step 2: Access Boot Menu
- **Press F9** immediately after power on
- You should now see your USB drive listed as:
  - **"UEFI: <USB Drive Name>"** ← Select this one!
  - Or just the USB drive name (it will boot UEFI automatically)

### Step 3: If USB Still Not Visible

#### Check UEFI Boot Order in BIOS:
1. Press **F10** to enter BIOS Setup
2. Navigate to **"Boot Options"**
3. Look for **"UEFI Boot Order"** (separate section from Legacy)
4. Your USB should appear here
5. Move it to the top
6. Save and Exit (F10)

#### Ensure Secure Boot is Disabled:
1. In BIOS (F10)
2. Go to **"Security"** → **"Secure Boot Configuration"**
3. Set **"Secure Boot"** to **"Disabled"**
4. Save and Exit

## What You'll See When Booting

### UEFI Boot:
```
🏔️  Archipelago Bitcoin Node OS
    GRUB bootloader
    Loading kernel...
```

### After Boot:
```
Welcome to Alpine Linux 3.19
Kernel 6.6.x-lts on an x86_64

localhost login: root
Password: <just press Enter>
```

## First-Time Installation

Once logged in as root:

```bash
# Run the automated installer
sh /media/*/archipelago/install.sh

# This will:
# - Install Alpine to the internal disk
# - Install Archipelago backend (5.7MB Rust binary)
# - Install Archipelago frontend (Vue.js web UI)
# - Install 21 app manifests (Bitcoin, Lightning, Web5, etc.)
# - Configure networking (DHCP on Ethernet)
# - Set up nginx, Podman, SSH
# - Create archipelago user

# After installation completes:
reboot

# Remove USB drive during reboot

# Login to installed system:
# Username: archipelago
# Password: archipelago (CHANGE THIS!)

# Change password immediately:
passwd

# Access web UI:
# http://<your-ip>:8100
```

## Troubleshooting

### USB Not Appearing in Boot Menu
1. Reflash USB with dd method (more reliable than Etcher)
2. Try different USB port (back panel USB 2.0 ports work best)
3. Try a different USB drive (some USBs don't work well for booting)

### Keyboard Not Working in BIOS
1. Use USB 2.0 port (black, not blue)
2. Try back panel USB ports
3. Try different keyboard
4. Reset BIOS (remove CMOS battery for 30 seconds)

### "Secure Boot Violation" Error
- Disable Secure Boot in BIOS (see steps above)

### Black Screen After Booting
- The system might be loading, wait 30 seconds
- Try pressing Enter to see login prompt
- If still black, try different video output (HDMI vs DisplayPort)

## System Information

### Hardware Support
- **CPU**: Intel Core i7-10710U (6 cores, 12 threads)
- **Architecture**: x86_64
- **Firmware**: UEFI
- **Network**: Automatic DHCP on Ethernet

### Included Components
- **Base OS**: Alpine Linux 3.19
- **Backend**: Archipelago Rust server (5.7MB)
- **Frontend**: Vue.js web UI (served on port 8100)
- **Container Runtime**: Podman (rootless)
- **App Manifests**: 21 pre-configured apps
  - Bitcoin Core
  - LND & Core Lightning
  - BTCPay Server
  - Nostr relays (nostr-rs-relay, strfry)
  - Web5 DWN & DID Wallet
  - Meshtastic & Router
  - Home Assistant
  - Grafana, SearXNG, Ollama
  - And more...

### Network Configuration
- **Default**: DHCP on all Ethernet interfaces
- **Management UI**: Port 8100
- **Backend API**: Port 8101
- **SSH**: Port 22 (enabled by default)

## Next Steps After Installation

1. **Access Web UI**: Browse to `http://<your-ip>:8100`
2. **Install Apps**: Use the web UI to install containerized apps
3. **Configure Bitcoin**: Set up Bitcoin Core node
4. **Set up Lightning**: Install LND or Core Lightning
5. **Explore**: Check out the 21 pre-configured app manifests

---

**ISO Ready to Flash!** 🚀

Flash this ISO to USB and boot your HP ProDesk - it will now work with UEFI!