carlos / todomvc-bakeoff Public

docs: the arm64 root is shared between builders

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Paul Campbell pushed by claude 1 day ago 2eeda2a8e0e29c1781362c6fdbd31c6f14b86087 parent 6ac2913

1 file changed, +6 −0

diff --git a/docs/toolchains.md b/docs/toolchains.md

index 2420b77..42fd42d 100644

--- a/docs/toolchains.md

+++ b/docs/toolchains.md

@@ -30,6 +30,12 @@ Everything in it runs emulated, so builds are several times slower than

native. Install extra Debian packages with

`scripts/arm64.sh apt-get install -y <pkg>`.

+**The root is shared.** Other builders use it at the same time. If `apt`

+or `dpkg` reports a lock, wait a minute and retry. Install what you need,

+but never remove or downgrade packages others may rely on, and keep your

+build output and caches under your own app directory (for example

+`apps/<slug>/.cache/`), not in the root's `/root` or `/tmp`.

To run any arm64 binary on docs-t1:

`qemu-aarch64-static -L ~/.local/share/bakeoff-toolchains/arm64root <binary>`.