<!--
SPDX-FileCopyrightText: (C) 2026 Intel Corporation
SPDX-License-Identifier: Apache-2.0
-->

# Build from Source

This guide covers Phase 1 of the provisioning workflow: building bootable USB artifacts on the developer system.

Before starting, confirm your system meets all [System Requirements](./system-requirements.md).

For Windows Subsystem for Linux (WSL), follow the steps in the [Windows WSL Guide](../how-to/set-up-windows-wsl.md).

## Phase 1: Build Artifacts on the Developer System

### 1. Clone the Repository

```bash
git clone --branch v2026.1.0 https://github.com/open-edge-platform/edge-node-infrastructure-blueprint.git
cd edge-node-infrastructure-blueprint
```

### 2. Build Bootable USB Artifacts

From the repository root, run one of the following build modes.

> **Note:** If your development environment is behind a firewall, add proxy configuration to the
> `proxy.env` file in the `edge-node-infrastructure-blueprint` directory. To skip the proxy settings,
> pass `skip-proxy=true` to the make command.

#### Option 1 (Recommended): Build from ISO

Build the Ubuntu image, including the required tools and packages, from an Ubuntu ISO image
file. For additional image customization, see the
[Ubuntu Desktop Raw Image Generation guide](https://github.com/open-edge-platform/edge-node-infrastructure-blueprint/blob/v2026.1.0/infrastructure/host-os/readme.md).

Before building, update the default user credentials in `infrastructure/host-os/auto-install-pkgs.yaml`. Replace the default `user` name and `passwd` hash with your own values:

```yaml
user-data:
  users:
  - name: <your-username>
    passwd: "<SHA-512-hashed-password>"
```

Generate the password hash using one of the following methods:

```bash
# Using openssl (requires `openssl` to be installed)
openssl passwd -6 'your-password-here'

# Using mkpasswd (requires `whois` to be installed)
mkpasswd --method=sha-512 'your-password-here'
```

> **Note:** The output changes on every invocation because the salt is randomly generated. All outputs verify against the same password.

```bash
make build MODE=image-from-iso ISO_URL=https://releases.ubuntu.com/24.04.4/ubuntu-24.04.4-desktop-amd64.iso
```

#### Option 2 (Advanced): Build with Image Composer Tool Image

This path is intended for advanced users who need fine-grained control over disk
layout, installed packages, and package repositories. Most users can start with
Option 1.

- [Advanced Image Customization (Using Image Composer Tool)](../how-to/advanced-image-customization.md).

### Build Output

With any of the above build options, expect the following output:

- `usb-installation-files.tar.gz` in `infrastructure/build-artifacts/out`

Once the build completes, continue to [Prepare USB and Validate](./prepare-usb.md).