This guide provides instructions on how to install Fuchsia on an
Intel [NUC](https://en.wikipedia.org/wiki/Next_Unit_of_Computing) (Next Unit of Computing) device.

The steps are:

1. [Prerequisites](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#prerequisites).
2. [Build Fuchsia](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#build-fuchsia).
3. [Prepare a USB drive](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#prepare-usb).
4. [Enable EFI booting on the NUC](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#enable-efi-booting).
5. [Install Fuchsia on the NUC](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#install-fuchsia).
6. [(Optional) Upload Fuchsia SSH keys to the NUC](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#upload-fuchsia-ssh-keys).

## Prerequisites

Before you start installing Fuchsia on a NUC device, make sure that
you've completed the following tasks:

- [Set up the Fuchsia development environment](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#set-up-fuchsia-env)
- [Get parts](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#get-parts)

### Set up the Fuchsia development environment

To set up the Fuchsia development environment on your workstation,
complete the [Get started with Fuchsia](https://fuchsia.dev/docs/get-started/README) guide.

### Get parts

> [!NOTE]
> **Note:** Fuchsia only supports the NUC configurations listed in [Supported system configurations](https://fuchsia.dev/docs/reference/hardware/support-system-config). However, unsupported NUC configurations may also work with Fuchsia. For more information on experimental setups, see [Experimental hardware](https://fuchsia.dev/docs/contribute/governance/rfcs/0111_fuchsia_hardware_specifications#experimental-hardware).

The following parts are required for this guide:

- A NUC device (see [example models](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#supported-nuc-models))
- A USB 3.0 flash drive
- A keyboard
- A mouse (Optional)
- A monitor with an HDMI port
- An HDMI cable
- An Ethernet cable
- A Phillips-head screwdriver (with a magnetic tip)

> [!NOTE]
> **Note:** The [*2. Build Fuchsia*](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#build-fuchsia) and [*3. Prepare a USB drive*](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#prepare-usb) sections do not require a NUC device, so you can complete these sections prior to obtaining a NUC device. However, you will need a USB flash drive for the *3. Prepare a USB drive* section.

## Build Fuchsia

Installing Fuchsia on a NUC device requires that you build an x64 image and
generate build artifacts (which include the Fuchsia installer) on your
workstation.

To build Fuchsia for NUC installation, do the following:

> [!CAUTION]
> **Caution:** **As of Jun 9, 2025** , the installation workflow using `recovery-installer` is broken at the moment. Please see the instructions in this [`README.md`](https://cs.opensource.google/fuchsia/fuchsia/+/main:src/firmware/gigaboot/boards/nuc/README.md) file instead.

1. Set your build configuration to an x64 target and include the
   `recovery-installer` package.

       fx set core.x64 --with //build/images/recovery:recovery-installer

2. Build Fuchsia:

       fx build

   Building Fuchsia can take up to 90 minutes.

## Prepare a USB drive

You need to prepare a bootable USB drive that runs the Fuchsia installer.
Later in the [Install Fuchsia on the NUC](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#install-fuchsia) section,
you will use this USB drive to boot your NUC into the Fuchsia installer.

> [!IMPORTANT]
> **Important:** The instructions below require that you've completed the build in the previous [Build Fuchsia](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#build-fuchsia) section.

To prepare a bootable USB drive, do the following:

1. Plug the USB drive into **your workstation**.

2. Identify the path to the USB drive:

       fx list-usb-disks

   This command prints output similar to the following:

       $ fx list-usb-disks
       /dev/sda - My Example USB Disk

3. Create a bootable USB drive:

       fx mkinstaller -v PATH_TO_USB_DRIVE

   Replace `PATH_TO_USB_DRIVE` with the path to the USB drive from the step
   above.

   The example command below selects the `/dev/sda` path:

       $ fx mkinstaller -v /dev/sda

   When finished, the command prints output similar to the following
   in the end:

       $ fx mkinstaller -v /dev/sda
       mkinstaller: WARNING: Changing ownership of /dev/sda to alice
       [sudo] password for alice:
       ...
       mkinstaller: INFO:    Writing image fvm.sparse.blk to partition storage-sparse...
       mkinstaller: INFO:      Wrote 835.6M in 35.55s, 23.5M/s
       mkinstaller: INFO: Done.
       mkinstaller: INFO: Ejected USB disk

4. Unplug the USB drive from the workstation.

## Enable EFI booting on the NUC

Update your NUC's BIOS setup so that it can boot from
a USB drive.

Two versions of BIOS are available on NUC devices: **Visual BIOS** (for instance, NUC7)
and **Aptio V BIOS** (for instance, NUC11). The steps are slightly different depending
on which BIOS is included in your system.

> [!IMPORTANT]
> **Important:** To be able to enter the BIOS setup mode, you may need to unplug the Ethernet cable from the NUC device if it's already connected to the host machine.

### Visual BIOS

![Visual BIOS](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/visual_bios.png "Screenshot showing Visual BIOS")

**Figure 1**. A screenshot of Visual BIOS

To enable EFI (Extensible Firmware Interface) booting on your NUC,
do the following:

1. Reboot your NUC.
2. To enter the BIOS setup, press `F2` while booting.
3. Click the **Advanced** button at the top.
4. Click the **Boot** tab.
5. Click the **Boot Priority** tab and confirm the following settings:

   - **UEFI Boot** is checked.
   - **Legacy Boot** is unchecked.

   ![Visual BIOS Boot Priority tab](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/visual_bios_boot_priority.png "Screenshot showing the Boot Priority tab in Visual BIOS")
6. Click the **Boot Configuration** tab and confirm the following settings:

   - In the **UEFI Boot** window:

     - **Boot USB Devices First** is checked.
     - **Boot Network Devices Last** is checked.
     - **Unlimited Network Boot Attempts** is checked.
   - In the **Boot Devices** window:

     - **USB** is checked.
     - **Network Boot** is set to `UEFI PXE & iSCSI`.

   ![Visual BIOS Boot Configuration](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/visual_bios_boot_configuration.png "Screenshot showing the Boot Configuration tab in Visual BIOS")
7. Click the **Secure Boot** tab and confirm the following settings:

   - **Secure Boot** is unchecked.

   ![Visual BIOS Secure Boot](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/visual_bios_secure_boot.png "Screenshot showing the Secure Boot tab Visual BIOS")
8. To save and exit BIOS, press `F10` and click **Yes**.

### Aptio V BIOS

![Aptio V BIOS](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/aptio_v_bios.png "Screenshot showing Aptio V BIOS")

**Figure 2**. A screenshot of Aptio V BIOS

To enable EFI (Extensible Firmware Interface) booting on your NUC,
do the following:

1. Reboot your NUC.
2. To enter the BIOS setup, press `F2` while booting.
3. Click the **Boot** tab.
4. Click **Secure Boot** and confirm the following settings:

   - **Secure Boot** is set to `Disabled`.

   ![Aptio V BIOS Secure Boot](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/aptio_v_bios_secure_boot.png "Screenshot showing the Secure Boot tab in Aptio V BIOS")
5. To return, click the **\<** button on the left.

6. Click **Boot Priority** and confirm the following settings:

   - **UEFI Boot** is checked.
   - **Legacy Boot** is unchecked.

     > [!NOTE]
     > **Note:** If you don't see the **UEFI Boot** and **Legacy Boot** options, it means that your system does not support legacy boot. Skip these first two checks.

   - **Boot USB Devices First** is checked.

   - **Boot Network Devices Last** is checked.

   - **Unlimited Boot to Network Attempts** is checked.

   - **USB** is checked.

   - **Network Boot** is set to `UEFI PXE & iSCSI`.

   ![Aptio V BIOS Boot Priority](https://fuchsia.dev/static/fuchsia-src/development/hardware/images/aptio_v_bios_boot_priority.png "Screenshot showing the Boot priority tab in Aptio V BIOS")
7. To save and exit BIOS, press `F10` and click **Ok**.

## Install Fuchsia on the NUC

Use the [bootable USB drive](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#prepare-usb) to boot your NUC into the Fuchsia
installer. It then installs the x64 image (which was built in the
[Build Fuchsia](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#build-fuchsia) section) to the NUC.

To install Fuchsia on your NUC, do the following:

1. Plug the bootable USB drive into the NUC.

2. Reboot your NUC.

   The NUC boots into the Fuchsia Installer (with a pink background).
3. Press **Enter** to select the `Install from USB` option.

4. Press **Enter** on other prompts to continue.

5. Once the installation completes, unplug the USB drive from the NUC device.

6. Reboot the NUC device.

   The NUC is now booted into Fuchsia.

> [!NOTE]
> **Note:** Later, if you need to install a new version of Fuchsia (for instance, after re-building a new image using `fx build`), see [Flash a new Fuchsia image to the NUC](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#flash-fuchsia) in Appendices.

## (Optional) Upload Fuchsia SSH keys to the NUC

If you plan on using this NUC device **for Fuchsia development** , you need
to flash a Fuchsia image to the NUC device from your host machine, which
in turn uploads the [Fuchsia-specific SSH keys](https://fuchsia.dev/docs/development/tools/ffx/workflows/create-ssh-keys-for-devices) to the NUC.
Once those Fuchsia-specific SSH keys are uploaded to the NUC, you can perform
[`ffx`-based workflows](https://fuchsia.dev/docs/development/tools/ffx/workflows/README) on the NUC from your host machine.

To upload Fuchsia SSH keys to the NUC, do the following:

1. Complete the steps in the
   [Flash a new Fuchsia image to the NUC](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#flash-fuchsia) section
   in Appendices.

2. To verify that you can connect to the NUC from the host machine,
   run the following command:

       ffx target show

   This command prints output similar to the following:

       $ ffx target show
       Target:
           Name: "fuchsia-54b2-0389-644b"
           SSH Address: "fe81::55b1:2ff2:fe34:567b%en10:22"
       Board:
           Name: "default-board"
           Revision: "1"
           Instruction set: "x64"
       ...

## Appendices

### Supported NUC models

For GPU support, get a NUC7 (Kaby Lake) or NUC8 (Coffee Lake), or a higher
generation.

The list below shows some example models:

- [Intel® NUC Kit NUC7i5DNKE](https://ark.intel.com/content/www/us/en/ark/products/122486/intel-nuc-kit-nuc7i5dnke.html)
- [Intel® NUC Kit NUC7i5DNHE](https://ark.intel.com/content/www/us/en/ark/products/122488/intel-nuc-kit-nuc7i5dnhe.html) (Best choice)
- [Intel® NUC Kit NUC7i3DNKE](https://ark.intel.com/content/www/us/en/ark/products/122495/intel-nuc-kit-nuc7i3dnke.html)
- [Intel® NUC Kit NUC7i3DNHE](https://ark.intel.com/content/www/us/en/ark/products/122498/intel-nuc-kit-nuc7i3dnhe.html)
- [Intel® NUC Kit NUC8i5BEK](https://ark.intel.com/content/www/us/en/ark/products/126147/intel-nuc-kit-nuc8i5bek.html)
- [Intel® NUC Kit NUC8i5BEH](https://ark.intel.com/content/www/us/en/ark/products/126148/intel-nuc-kit-nuc8i5beh.html)
- [Intel® NUC Kit NUC8i3BEK](https://ark.intel.com/content/www/us/en/ark/products/126149/intel-nuc-kit-nuc8i3bek.html)
- [Intel® NUC Kit NUC8i3BEH](https://ark.intel.com/content/www/us/en/ark/products/126150/intel-nuc-kit-nuc8i3beh.html)

### Flash a new Fuchsia image to the NUC

Once a NUC is running Fuchsia, you can use Fuchsia's flashing
mechanism to provision a new Fuchsia image to the NUC.

To flash a Fuchsia image to your NUC, do the following:

1. Connect the NUC directly to the workstation using an Ethernet cable.

   (Or you can also connect the NUC to a router or WiFi modem in the same
   Local Area Network as the workstation.)

   > [!NOTE]
   > **Note:** Network booting only works with the NUC's built-in Ethernet port. Netbooting with an USB port (via an Ethernet-to-USB adapter) is not supported.

2. Reboot your NUC.

3. On Fuchsia's boot screen, press the `f` key to select the `fastboot` option.

   Once the NUC is in Fastboot mode, it prints `Fastboot TCP is ready`
   on the screen.
4. **On your workstation**, discover the NUC in Fastboot mode:

       ffx target list

   This command prints output similar to the following:

       $ ffx target list
       NAME                      SERIAL       TYPE       STATE       ADDRS/IP                           RCS
       fuchsia-54b2-0389-644b    <unknown>    Unknown    Fastboot    [fe81::55b1:2ff2:fe34:567b%en10]    N

   Verify that the device's state is `Fastboot`.
5. Flash a new Fuchsia image to the NUC:

   > [!NOTE]
   > **Note:** To build a new Fuchsia image, see the [Build Fuchsia](https://fuchsia.dev/fuchsia-src/development/hardware/intel_nuc#build-fuchsia) section above.

       fx flash

   If you have multiple devices connected to the host machine previously, you may need to
   explicitly specify the name of the NUC device, for example:

       fx flash -s fuchsia-54b2-0389-644b

   When finished, the NUC reboots and starts running the new Fuchsia image.

### Remote management of NUC devices

To enable remote management, including KVM, you need to configure
Intel [AMT](https://www.intel.com/content/www/us/en/architecture-and-technology/intel-active-management-technology.html) (Active Management Technology).

> [!NOTE]
> **Note:** This assumes you're using NUC connected to the EdgeRouter. If your networking setup is different, you may need a different network configuration.

First, configure Intel ME on your NUC:

1. Reboot your NUC.
2. Enter Intel ME settings by pressing `Ctrl+P` on the boot screen.
3. Select **MEBx Login**
4. Set up a new password, the default one is `admin`.

   > [!NOTE]
   > **Note:** The password must be at least 8 characters long, contain both lowercase and uppercase characters, at least one digit and at least one non alphanumeric character ("_" is considered alphanumeric).

   > [!TIP]
   > **Tip:** If you choose a password that is exactly 8 characters long, you can use the same password as the VNC password below.

5. Configure network:

   1. Select **Intel(R) AMT Configuration**.
   2. Unconfigure existing network settings:

      1. Select **Unconfigure Network Access**
      2. Select **Full Unprovision**
      3. Press `Y` to confirm.
   3. Select **Network Setup** \> **TCP/IP Settings** \> **Wired LAN IPV4 Configuration**.

   4. Set **DHCP Mode** to **Disabled**.

   5. Set **IPV4 Address** to an address reachable from your host machine via the EdgeRouter.

      On your host machine, run `ifconfig` and find the entry that corresponds to the EdgeRouter, for example:

          $ ifconfig
          enx00e04c0c13ba: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
                  inet 192.168.42.86  netmask 255.255.255.0  broadcast 192.168.42.255
                  ...

      In this case, you could try using the address **192.168.42.20**
   6. Set **Subnet Mask Address** to the netmask of your host machine to EdgeRouter connection, for example **255.255.255.0**.

   7. Press `Esc` until you return to **Intel(R) AMT Configuration**.

   8. Select **Activate Network Access** and press `Y` to confirm.

   9. Exit Intel ME settings and save your changes.

Now, configure the [`amtctrl`](https://github.com/sdague/amt) command-line utility on your host machine:

These instructions assume you have set some environment variables:

- `AMT_HOST`: The IPv4 address you configured in the Intel ME settings.
- `AMT_PASSWORD`: The password you chose for Intel ME.
- `VNC_PASSWORD`: A password for accessing the NUC over VNC.

> [!NOTE]
> **Note:** The password used for `VNC_PASSWORD` must be *exactly* 8 characters long, must contain both lowercase and uppercase characters, at least one digit and at least one non alphanumeric character.

1. Clone the `amtctrl` repository:

       git clone https://github.com/sdague/amt

2. Install `amtctrl`:

       cd amt && sudo ./setup.py install

3. Configure NUC IP address and passwords:

       amtctrl set -V $VNC_PASSWORD nuc $AMT_HOST $AMT_PASSWORD

4. Enable VNC:

       amtctrl nuc vnc

Now, you can access the NUC from your host machine using any VNC client by connecting to
the IP address set in `AMT_HOST`. Enter the password set in `VNC_PASSWORD` when prompted.

> [!NOTE]
> **Note:** The NUC needs to be plugged in to a monitor with a HDMI cable to accept VNC connections.

You can also turn on, turn off or reboot the NUC with the following terminal commands:

- To turn on the NUC:

      amtctrl nuc on

- To turn off the NUC:

      amtctrl nuc off

- To reboot the NUC:

      amtctrl nuc reboot

[](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/development/hardware/intel_nuc.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/development/hardware/intel_nuc.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/development/hardware/intel_nuc.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/development/hardware/intel_nuc.md "Edit the source code of this page")