Install Fuchsia on a NUC
This document describes how to get a NUC up and running with Fuchsia.
1. Get Parts {#get-parts}
You need the following:
- USB 3.0 Drive
- NUC
- RAM
- m.2 SSD
- Keyboard
- Monitor that supports HDMI
- HDMI cable
- Ethernet cable
- Magnetic tip phillips head screwdriver
This table shows some example parts you can get from Amazon.
Item | Link | Notes: |
---|---|---|
NUC | B01MSZLO9P | Get a NUC7 (Kaby Lake) or NUC6 (Skylake) for GPU support. |
RAM | B01BIWKP58 | Works fine. |
SSD | B01IAGSDJ0 | Works fine. You only need one of these SSDs. |
SSD | B00TGIVZTW | Works fine. |
SSD | B01M9K0N8I | Works fine. |
Monitor | B015WCV70W | Works fine. |
HDMI Cable | B014I8SIJY | Works fine. |
Keyboard | B00B7GV802 | Works fine. It also includes a mouse. |
USB 3.0 drive | B01BGTG41W | Works fine. |
2. Prepare the NUC {#prepare-the-nuc}
NUCs don’t come with RAM or an SSD, so you need to install them.
Follow the instructions to install the RAM and SSD on the NUC:
Remove the phillips screws in the bottom feet of the NUC.
- Install the RAM.
- Remove the phillips screw that will hold the SSD in place (phillips screwdriver with magnetic tip is useful here).
- Install the SSD.
Screw the SSD in place using screw from Step 3.
- Replace bottom and screw feet back in.
- Plug power, ethernet cable, HDMI, and keyboard into the NUC.
- Plug the other end of the ethernet cable into your build workstation or the router/switch that connects to your build workstation.
3. Enable EFI booting {#enable-efi-booting}
- Reboot NUC.
- Press F2 while booting to enter BIOS.
- In the Boot Order window on the left, click the Legacy tab.
Uncheck ‘Legacy Boot’.
- Click the
Advanced
button and confirm the following boot configuration:- Select the
Boot Priority
tab.- Check
UEFI Boot
. - Set
USB
the first entry in the boot order.
- Check
- Select the
Boot configuration
tab.- Check
Boot Network Devices Last
. - Check
Unlimited Network Boot Attempts
. - Check
USB boot devices
. - Set
Network boot
toUEFI PXE & iSCSI
.
- Check
- Select the
- Select the
Secure Boot
tab and uncheckSecure Boot
. - Press F10 to save the changes and exit BIOS.
Note: Network booting only works with the NUC’s built-in ethernet, netbooting via USB-ethernet dongle is unsupported.
If you want to remotely manage the device, see Remote Management for NUC.
4. Build Fuchsia {#build-fuchsia}
- Follow the getting started guidelines. Make sure to
use the board configuration
x64
when runningfx set
. For examplefx set core.x64
.
5. Pave Fuchsia {#pave-fuchsia}
- Plug your USB key into your build workstation.
- Identify the path to your USB key by running
fx list-usb-disks
. - Create a Zedboot USB by running
fx mkzedboot /path/to/usb/disk
. - Plug the Zedboot USB key into the NUC and boot it.
- When Zedboot is started, press Alt+F3 to switch to a command line prompt.
- Run
lsblk
on the device. Take note of the HDD or SSD’s block device path.- An example path looks like
/dev/sys/pci/00:17.0/ahci/sata0/block
- An example path looks like
- Run
install-disk-image init-partition-tables --block-device <BLOCK_DEVICE_PATH>
on the device to wipe and initialize the partition tables on the NUC. Use the block device path from the previous step. - Run
fx serve
on your workstation to install Fuchsia on the NUC. - After paving is completed, disconnect the USB key.