From c0248a1c240ae8d75eff880b9e9a23ee0f4a5b28 Mon Sep 17 00:00:00 2001
From: Michael Vogt <michael.vogt@gmail.com>
Date: Tue, 25 Mar 2025 13:16:15 +0100
Subject: [PATCH] README: document that cross building works

Document how cross building works.
---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 4e878fa..192aa0c 100644
--- a/README.md
+++ b/README.md
@@ -121,6 +121,20 @@ $ sudo image-builder build qcow2 --blueprint ./config.toml --distro centos-9
 ...
 ```
 
+### Cross architecture building
+
+When `qemu-user-static` is installed images can be build for foreign
+architectures. To do this, pass `--arch`, e.g.:
+
+```console
+$ sudo image-builder build --arch=riscv64 minimal-raw --distro fedora-41
+```
+building is about 8x-10x slower than native building but still fast
+enough to be usable.
+
+Note that this feature is considered experimental currently.
+
+
 ### SBOMs
 
 It is possible to generate spdx based SBOM (software bill of materials)