diff --git a/README.md b/README.md index f15f076..fd25feb 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ either Debian Buster or Ubuntu Xenial and is known to have issues building on earlier releases of these systems. On other Linux distributions it may be possible to use the Docker build described below. -To install the required dependencies for pi-gen you should run: +To install the required dependencies for pi-gen you should run (*): ```bash apt-get install coreutils quilt parted qemu-user-static debootstrap zerofree zip \ @@ -20,6 +20,22 @@ dosfstools bsdtar libcap2-bin grep rsync xz-utils file git curl The file `depends` contains a list of tools needed. The format of this package is `[:]`. +**(*) Warning:** please note that there is currently an issue when building with the +64-bits version of the `qemu-user-static` package. As a workaround, you can use the +32-bits `qemu-user-static:i386` package instead. + +To do this, first add the `i386` architecture to your Debian-based system: + +```bash +dpkg --add-architecture i386 +apt-get update +``` + +Then replace `qemu-user-static` with `qemu-user-static:i386` in the instructions above. + +Also note that the included Dockerfile in pi-gen already includes this workaround. + +For more info refer to: https://github.com/RPi-Distro/pi-gen/issues/271 ## Config @@ -295,9 +311,6 @@ follows: # Troubleshooting -## `64 Bit Systems` -Please note there is currently an issue when compiling with a 64 Bit OS. See https://github.com/RPi-Distro/pi-gen/issues/271 - ## `binfmt_misc` Linux is able execute binaries from other architectures, meaning that it should be