122 lines
2.8 KiB
Markdown
122 lines
2.8 KiB
Markdown
# 🍪 CODE CRISPIES Workshop
|
|
## USB Boot Instructions
|
|
|
|
### 📋 Quick Reference Card
|
|
|
|
**Your assigned server:** `__________.codecrispies.es`
|
|
**Workshop WiFi:** `CODE_CRISPIES_GUEST` / Password: `workshop2024`
|
|
|
|
---
|
|
|
|
## 💻 How to Boot from USB Drive
|
|
|
|
### Step 1: Insert USB Drive
|
|
- Insert the CODE CRISPIES workshop USB drive
|
|
- Do NOT remove it until workshop ends
|
|
|
|
### Step 2: Boot from USB
|
|
|
|
#### 🖥️ **Desktop PC / Most Laptops**
|
|
1. **Restart** your computer
|
|
2. **Press and HOLD** one of these keys immediately as it starts:
|
|
- `F12` (most common)
|
|
- `F11`
|
|
- `F9`
|
|
- `ESC`
|
|
3. Select **USB Drive** or **UEFI: USB Drive** from boot menu
|
|
4. Press `Enter`
|
|
|
|
#### 🍎 **Mac (Intel)**
|
|
1. **Restart** your Mac
|
|
2. **Press and HOLD** `Option` (⌥) key immediately
|
|
3. Select the **USB drive** (may show as "EFI Boot")
|
|
4. Press `Enter`
|
|
|
|
#### 🍎 **Mac (Apple Silicon M1/M2)**
|
|
1. **Shut down** completely
|
|
2. **Press and HOLD** the power button until you see startup options
|
|
3. Select the **USB drive** option
|
|
4. Click **Continue**
|
|
|
|
#### 🔧 **If Boot Menu Doesn't Appear**
|
|
|
|
**Windows PC:**
|
|
1. Boot into Windows
|
|
2. Hold `Shift` + click **Restart**
|
|
3. Choose **Troubleshoot** → **Advanced** → **UEFI Firmware**
|
|
4. Find **Boot Order** settings
|
|
5. Move **USB Drive** to top of list
|
|
6. Save and exit
|
|
|
|
**Popular Manufacturer Keys:**
|
|
- **Dell:** `F12`
|
|
- **HP:** `F9` or `ESC` then `F9`
|
|
- **Lenovo:** `F12` or `Fn + F12`
|
|
- **ASUS:** `F8` or `ESC`
|
|
- **Acer:** `F12`
|
|
- **MSI:** `F11`
|
|
- **Samsung:** `F2` then navigate to Boot tab
|
|
- **Toshiba:** `F12`
|
|
|
|
---
|
|
|
|
## ✅ What You Should See
|
|
|
|
1. **NixOS Boot Screen** appears
|
|
2. System loads (takes 30-60 seconds)
|
|
3. **Desktop environment** starts automatically
|
|
4. **Terminal opens** with CODE CRISPIES welcome message
|
|
5. You see available servers and commands
|
|
|
|
---
|
|
|
|
## 🚀 Getting Started Commands
|
|
|
|
```bash
|
|
# Connect to your assigned server
|
|
connect hopper
|
|
|
|
# See available app recipes
|
|
recipes
|
|
|
|
# Get help
|
|
help
|
|
```
|
|
|
|
---
|
|
|
|
## 📱 Mobile Hotspot Instructions
|
|
**If WiFi isn't working:**
|
|
|
|
**iPhone:**
|
|
Settings → Personal Hotspot → Turn On
|
|
Name: iPhone, Password: (ask facilitator)
|
|
|
|
**Android:**
|
|
Settings → Network → Hotspot & Tethering → Mobile Hotspot
|
|
Name: Android, Password: (ask facilitator)
|
|
|
|
---
|
|
|
|
## 🆘 Troubleshooting
|
|
|
|
❌ **"No bootable device"**
|
|
→ Try different F-key (F11, F9, ESC)
|
|
→ USB drive may not be properly inserted
|
|
|
|
❌ **Mac won't boot USB**
|
|
→ USB drive might need to be reformatted for Mac
|
|
→ Ask facilitator for Mac-compatible USB
|
|
|
|
❌ **Boots to Windows/Mac instead**
|
|
→ You didn't press the boot key fast enough
|
|
→ Restart and try again immediately
|
|
|
|
❌ **Terminal doesn't open**
|
|
→ Click terminal icon in taskbar
|
|
→ Or press `Ctrl + Alt + T`
|
|
|
|
❌ **Can't connect to internet**
|
|
→ Try different WiFi network
|
|
→ Use mobile hotspot as backup
|