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.

For Windows Subsystem for Linux (WSL), follow the steps in the Windows WSL Guide.

Phase 1: Build Artifacts on the Developer System#

1. Clone the Repository#

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.

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:

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

Generate the password hash using one of the following methods:

# 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.

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).

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.