How to make a cross architecture chroot - Revision history

Lotheac: /* Troubleshooting */

2026-02-04T13:07:54Z

Troubleshooting

← Older revision		Revision as of 13:07, 4 February 2026
Line 70:		Line 70:
	==Troubleshooting==		==Troubleshooting==

	If you get a <code>ERROR: ${package_name}.post-install: script exited with error 127</code> while trying to add the alpine-base, that normally means that qemu binfmt_misc hasn't been setup properly. Check if the <code>qemu-$arch</code> package has been installed and see if the ~~binfmt_misc~~ service is running. Remember to restart the service after adding a new architecture.		If you get a <code>ERROR: ${package_name}.post-install: script exited with error 127</code> while trying to add the alpine-base, that normally means that qemu binfmt_misc hasn't been setup properly. Check if the <code>qemu-$arch</code> package has been installed and see if the binfmt service is running. Remember to restart the service after adding a new architecture.

	{{Cmd\|# rc-service ~~qemu-~~binfmt restart}}		{{Cmd\|# rc-service binfmt restart}}

	You can also see if there is a <code>qemu-$arch</code> entry in <code>/proc/sys/fs/binfmt_misc/</code>.		You can also see if there is a <code>qemu-$arch</code> entry in <code>/proc/sys/fs/binfmt_misc/</code>.

Lotheac at 13:05, 4 February 2026

2026-02-04T13:05:16Z

← Older revision		Revision as of 13:05, 4 February 2026
Line 21:		Line 21:
	{{Tip\|This section applies to Alpine 3.24 and later. In earlier releases, enable <code>qemu-binfmt</code> instead of <code>binfmt</code>.}}		{{Tip\|This section applies to Alpine 3.24 and later. In earlier releases, enable <code>qemu-binfmt</code> instead of <code>binfmt</code>.}}

	The binfmt service registers binfmt_misc handlers from configuration files in binfmt.d directories when it starts. The qemu-* ~~static~~ packages include the necessary ~~binfmt.d~~ configuration files~~. Add~~ the service to the default runlevel and start it:		The binfmt service registers <code>binfmt_misc</code> handlers from configuration files in <code>binfmt.d</code> directories when it starts. The <code>qemu-*</code> user mode packages include the necessary configuration files, so it is sufficient to add the service to the default runlevel and start it:

	{{Cmd\|# rc-update add binfmt		{{Cmd\|# rc-update add binfmt

Lotheac: qemu-binfmt -> binfmt

2026-02-04T12:56:40Z

qemu-binfmt -> binfmt

← Older revision		Revision as of 12:56, 4 February 2026
Line 17:		Line 17:
	Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.		Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.

	== Enable the <code>~~qemu-~~binfmt</code> service and start it ==		== Enable the <code>binfmt</code> service and start it ==

	~~The~~ qemu-binfmt ~~script is an OpenRC init script that registers the binfmt_misc handlers when the service starts and unregisters them when the service stops~~. ~~Add the service to the default runlevel and start it immediately:~~		{{Tip\|This section applies to Alpine 3.24 and later. In earlier releases, enable <code>qemu-binfmt</code> instead of <code>binfmt</code>.}}

	{{Cmd\|# rc-update add ~~qemu-~~binfmt ~~default~~		The binfmt service registers binfmt_misc handlers from configuration files in binfmt.d directories when it starts. The qemu-* static packages include the necessary binfmt.d configuration files. Add the service to the default runlevel and start it:
	# rc-service ~~qemu-~~binfmt start}}
			{{Cmd\|# rc-update add binfmt
			# rc-service binfmt start}}

	== Make the chroot folder ==		== Make the chroot folder ==

Rotu: Add openrc package, which is needed to run `rc-service`

2025-02-26T19:50:01Z

Add openrc package, which is needed to run `rc-service`

← Older revision		Revision as of 19:50, 26 February 2025
Line 13:		Line 13:
	'''[[Repositories#Managing_repositories\| Enable the Community Repository]]''' and install the '''qemu''' user mode binaries for the architectures you want to use, in this case x86_64 and i386:		'''[[Repositories#Managing_repositories\| Enable the Community Repository]]''' and install the '''qemu''' user mode binaries for the architectures you want to use, in this case x86_64 and i386:

	{{Cmd\|# apk add {{Pkg\|qemu-x86_64}} {{Pkg\|qemu-i386}} {{Pkg\|qemu-openrc}}}}		{{Cmd\|# apk add {{Pkg\|qemu-x86_64}} {{Pkg\|qemu-i386}} {{Pkg\|qemu-openrc}} {{Pkg\|openrc}}}}

	Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.		Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.

WhyNotHugo: /* The exciting part: Enter the chroot */ The above process does not install ash

2025-02-25T15:15:49Z

The exciting part: Enter the chroot: The above process does not install ash

← Older revision		Revision as of 15:15, 25 February 2025
Line 62:		Line 62:
	==The exciting part: Enter the chroot==		==The exciting part: Enter the chroot==

	If you've followed all the steps, this part should be uneventful. The <code>chroot</code> invocation uses the special command of <code>~~ash~~ -l</code> to run as a login shell and source <code>/etc/profile</code>:		If you've followed all the steps, this part should be uneventful. The <code>chroot</code> invocation uses the special command of <code>sh -l</code> to run as a login shell and source <code>/etc/profile</code>:

	{{Cmd\|# chroot $CHROOT/ ~~ash~~ -l}}		{{Cmd\|# chroot $CHROOT/ sh -l}}

	==Troubleshooting==		==Troubleshooting==

Aqaqland: /* Troubleshooting */

2025-02-06T06:43:13Z

Troubleshooting

← Older revision		Revision as of 06:43, 6 February 2025
Line 68:		Line 68:
	==Troubleshooting==		==Troubleshooting==

	If you get a <code>ERROR: ${package_name}.post-install: script exited with error 127</code> while trying to add the alpine-base, that normally means that qemu binfmt_misc hasn't been setup properly. Check if the <code>qemu-$arch</code> package has been installed and see if the binfmt_misc service is running. You can also see if there is a <code>qemu-$arch</code> entry in <code>/proc/sys/fs/binfmt_misc/</code>.		If you get a <code>ERROR: ${package_name}.post-install: script exited with error 127</code> while trying to add the alpine-base, that normally means that qemu binfmt_misc hasn't been setup properly. Check if the <code>qemu-$arch</code> package has been installed and see if the binfmt_misc service is running. Remember to restart the service after adding a new architecture.

			{{Cmd\|# rc-service qemu-binfmt restart}}

			You can also see if there is a <code>qemu-$arch</code> entry in <code>/proc/sys/fs/binfmt_misc/</code>.

	Programs that use [https://en.wikipedia.org/wiki/Netlink Netlink] (e.g. <code>ip addr</code>) don't seem to work properly since qemu doesn't emulate the Netlink protocol properly.		Programs that use [https://en.wikipedia.org/wiki/Netlink Netlink] (e.g. <code>ip addr</code>) don't seem to work properly since qemu doesn't emulate the Netlink protocol properly.

Psykose: type

2023-07-11T07:08:31Z

type

← Older revision		Revision as of 07:08, 11 July 2023
Line 13:		Line 13:
	'''[[Repositories#Managing_repositories\| Enable the Community Repository]]''' and install the '''qemu''' user mode binaries for the architectures you want to use, in this case x86_64 and i386:		'''[[Repositories#Managing_repositories\| Enable the Community Repository]]''' and install the '''qemu''' user mode binaries for the architectures you want to use, in this case x86_64 and i386:

	{{Cmd\|# apk add {{Pkg\|qemu-x86_64}} {{Pkg\|qemu-i386}}}} {{Pkg\|qemu-openrc}}		{{Cmd\|# apk add {{Pkg\|qemu-x86_64}} {{Pkg\|qemu-i386}} {{Pkg\|qemu-openrc}}}}

	Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.		Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.

Psykose: use qemu-openrc instead of linked script, as it only depends on socat+qemu (base) anyway

2023-07-11T07:08:18Z

use qemu-openrc instead of linked script, as it only depends on socat+qemu (base) anyway

← Older revision		Revision as of 07:08, 11 July 2023
Line 13:		Line 13:
	'''[[Repositories#Managing_repositories\| Enable the Community Repository]]''' and install the '''qemu''' user mode binaries for the architectures you want to use, in this case x86_64 and i386:		'''[[Repositories#Managing_repositories\| Enable the Community Repository]]''' and install the '''qemu''' user mode binaries for the architectures you want to use, in this case x86_64 and i386:

	{{Cmd\|# apk add {{Pkg\|qemu-x86_64}} {{Pkg\|qemu-i386}}}}		{{Cmd\|# apk add {{Pkg\|qemu-x86_64}} {{Pkg\|qemu-i386}}}} {{Pkg\|qemu-openrc}}

	Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.		Please note there are the <code>qemu-system-*</code> packages, you don't want those since they are used for full virtual machine emulation.

	~~Then, <code>curl</code> my modified version of the qemu-binfmt script (originally from the [https://pkgs.alpinelinux.org/package/edge/community/aarch64/qemu-openrc qemu-openrc] package):~~

	~~{{Cmd\|# curl -o /etc/init.d/qemu-binfmt '<nowiki>https://gist.githubusercontent.com/ktprograms/c8ea850abde717376ff7a6f83dbabb2f/raw/0ff0596e8f9f1891f272393fa1ff0529bcbcef5d/qemu-binfmt</nowiki>'}}~~

	I prefer to use this script instead of installing the {{Pkg\|qemu-openrc}} package since that adds a lot of unneeded dependencies. Right now this only supports i386, x86_64, arm, ppc64le and s390x but I'll be adding all the architectures soon.

	~~Make the qemu-binfmt script executable:~~

	~~{{Cmd\|# chmod +x /etc/init.d/qemu-binfmt}}~~

	== Enable the <code>qemu-binfmt</code> service and start it ==		== Enable the <code>qemu-binfmt</code> service and start it ==

Bbbhltz: formatting, fixed broken link

2023-06-01T07:57:26Z

formatting, fixed broken link

Show changes

Encode: Change link to Repositories page

2022-06-27T03:41:18Z

Change link to Repositories page

← Older revision		Revision as of 03:41, 27 June 2022
Line 12:		Line 12:
	==Installing necessary software==		==Installing necessary software==

	First, [[~~Enable Community Repository~~ \| Enable the Community Repository]]. Next, install the qemu user mode binaries for the architectures you want to use, in this case x86_64 and i386:		First, [[Repositories#Enabling_the_community_repository\| Enable the Community Repository]]. Next, install the qemu user mode binaries for the architectures you want to use, in this case x86_64 and i386:

	<pre>		<pre>