Refactor build script for custom ISO creation and update hardware configuration

- Replaced OS-specific build method with a custom ISO builder in the build-for-hardware.sh script. - Updated output file naming to reflect the correct Alpine version in the build process. - Adjusted build dates in hardware configuration files for HP ProDesk, merged, and Start9 Pure profiles to the latest timestamp.
2026-01-31 22:56:39 +00:00
parent bd39de98e2
commit 76782073c2
23 changed files with 3285 additions and 23 deletions
@@ -0,0 +1,185 @@
+# 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!