Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

docs(verse): pin the Linux cross toolchain and name the missing engine component (#1117)

Ruben Lütke4d670558d307
diff --git a/docs/verse/unreal/architecture.md b/docs/verse/unreal/architecture.md
index edbc6a8e91..3d44078822 100644
--- a/docs/verse/unreal/architecture.md
+++ b/docs/verse/unreal/architecture.md
@@ -390,7 +390,9 @@ can (size, memory under `-nullrhi`).
|---|---|
| Engine | Binary 5.7.1 install, never in the repo (engine EULA). Version pinned in `Verse.uproject` and checked by CI |
| Windows compiler | Visual Studio 2022 Build Tools with the MSVC and Windows SDK versions 5.7 requires; not installed on the dev box on 2026-11-02, first setup step |
-| Linux | The engine's clang cross-compile toolchain for 5.7, installed on the dev box, `LINUX_MULTIARCH_ROOT` set; version pinned in `unreal/Toolchain/toolchains.json`. Linux Game target built from Windows; tests run in a Linux container or VM on the same box |
+| Linux | The engine's clang cross-compile toolchain for 5.7, installed on the dev box, `LINUX_MULTIARCH_ROOT` set; version pinned in `unreal/Toolchain/toolchains.json`. Linux Game target built from Windows; tests run in a Linux container or VM on the same box. Facts from 2026-11-02 below |
+| Linux toolchain pin | `v26_clang-20.1.8-rockylinux8` (`Engine/Config/Linux/Linux_SDK.json`: Main, Min and Max version are all this one). Vendor installer `https://cdn.unrealengine.com/CrossToolchain_Linux/v26_clang-20.1.8-rockylinux8.exe`, 1,014,385,664 bytes, SHA-256 `02DEE9F48CC65C5ABBC9CC429271115F1CCE68EBCEF632DB42BA4B5C9DBE2088`, Authenticode-signed by the engine vendor. The NSIS installer demands elevation; extracting its payload with 7-Zip (`7z x -tNsis`) gives the same tree without it. Dev box: `C:\UnrealToolchains\v26_clang-20.1.8-rockylinux8\`, user variable `LINUX_MULTIARCH_ROOT` set to that path, `clang++ --version` reports 20.1.8 |
+| Linux engine component | A binary install builds Linux targets only when the launcher's optional "Linux" target platform is installed: UBT checks for `Engine\Binaries\Linux\UnrealGame.target` (`BaseEngine.ini`, `InstalledPlatformConfigurations`) and otherwise stops with "Missing files required to build Linux targets". The dev box install has no `Engine/Binaries/Linux` on 2026-11-02; the person adds it once through the launcher (UE 5.7, Options, Target Platforms, Linux) |
| DDC | Local Zen DDC on `C:` capped at 40 GB (106 GB free on 2026-11-02, `orchestration.md` §4); `-ddc=` policy in `unreal/Toolchain/ddc.json`. No shared cloud DDC |
| Repo | `unreal/` with a nested `unreal/Verse/.gitattributes` routing `*.uasset`, `*.umap` and the few other allowed binaries to LFS; One File Per Actor; a nested `unreal/Verse/.gitignore` ignores `Binaries/`, `Intermediate/`, `Saved/`, `DerivedDataCache/`. All repo gate rules are in section 8.4 |
| Targets | `Verse.Target.cs` (Game) and `VerseEditor.Target.cs` only. `VerseHarness` is listed only in the Editor target; the `VerseServer.Target.cs` that exists today is deleted in G0 (binary installs cannot build Server targets, section 3.1) |