Test Images

FirmwareCI provides ready-to-use NixOS-based images designed to boot your hardware into a test environment. These images are the recommended way to prepare devices for automated FirmwareCI testing, ensuring all required capabilities for our test steps are available on the device.

You can either use these pre-provided images directly, or use them as a base configuration to customize for your specific needs.
Simply flash or boot one of these images on your target hardware to boot up your machine with all the necessary tooling.

For the chipsec test step, use the dedicated chipsec image provided by FirmwareCI. This image includes all necessary dependencies and tooling required to run chipsec tests reliably on your hardware.

View on GitHub

Note:
The default FirmwareCI images are configured to allow SSH access to the root user:

    users.users.root.openssh.authorizedKeys.keys = [
        "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKcSD9iHnCrJXkSt7aGSnfL0tVHUm+x6/EDr/FchmBfu"
    ];

This configuration allows FirmwareCI to securely connect to your device via SSH using a preconfigured key at /root/.ssh/fwci inside the test environment. You may also customize the SSH access settings to suit your specific requirements.

Example SSH transport configuration for FirmwareCI to connect to the machine:

transport: &transport
  proto: ssh
  options:
    host: "my.network"
    user: root
    identity_file: /root/.ssh/fwci #pre-configured SSH-key

Caution:
Do not enable this configuration on devices connected to publicly accessible networks, as it may expose your system to unauthorized access.