This document describes how to get a NUC up and running with Fuchsia.
You need the following:
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. |
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.
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:
Boot Priority
tab.UEFI Boot
.USB
the first entry in the boot order.Boot configuration
tab.Boot Network Devices Last
.Unlimited Network Boot Attempts
.USB boot devices
.Network boot
to UEFI PXE & iSCSI
.Select the Secure Boot
tab and uncheck Secure 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.
x64
when running fx set
. For example fx set core.x64
.Before installing Fuchsia to a device you need to prepare a bootable USB drive. On a NUC, Fuchsia boots via a chain of bootloaders. The instructions below will create a drive containing the first two steps in the chain: Gigaboot and Zedboot. Gigaboot is a UEFI boot shim with some limited functionality including netbooting, and flashing. By default, Gigaboot will chain into Zedboot, which is a bootloader built on top of Zircon and either boots into Fuchsia or allows you to pave your device. To get started you want to boot into Zedboot and pave Fuchsia to your device's storage.
fx list-usb-disks
.fx mkzedboot /path/to/usb/disk
.For more detailed instructions on preparing a bootable USB drive, see this guide.
lsblk
on the device. Take note of the HDD or SSD's block device path./dev/sys/platform/pci/00:17.0/ahci/sata0/block
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.fx serve
on your workstation to install Fuchsia on the NUC.Fuchsia is now installed on your device, when you reboot the device it will load Gigaboot, then Zedboot, then Fuchsia all from your device's storage. You no longer need the USB drive. If you need to pave a new version of Fuchsia, you can run fx reboot -r
on your workstation to reboot the device into Zedboot.