From b4361e9b882fbf2988cd0de38b2a7c4d0c85f34f Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 24 May 2024 09:30:23 -0700 Subject: [PATCH] edits to Ubuntu help on advanced page --- src/pages/get-started/install-advanced.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/pages/get-started/install-advanced.md b/src/pages/get-started/install-advanced.md index 3d42ec0a5..e3b02adea 100644 --- a/src/pages/get-started/install-advanced.md +++ b/src/pages/get-started/install-advanced.md @@ -269,18 +269,20 @@ rm ~/.nix-profile ## Fixing the SUID sandbox error in Ubuntu 24.04 -Ubuntu 24.04 [introduced an AppArmor security policy](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that causes `hc spin`, which is used to test applications and their UIs, to fail with a fatal error: +Ubuntu 24.04 [introduced an AppArmor security policy](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that causes `hc spin`, which is used to test applications and their UIs, to fail with a fatal error. If you have a `package.json` that lists `@holochain/hc-spin` as a dev dependency, you may see this error message: ``` [FATAL:setuid_sandbox_host.cc(158)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /node_modules/electron/dist/chrome-sandbox is owned by root and has mode 4755. ``` -Following those instructions by entering the following command in your project's root directory will fix the issue: +You can fix the issue by entering the following command in your project's root directory: ```shell chmod 4755 node_modules/electron/dist/chrome-sandbox && sudo chown root:root node_modules/electron/dist/chrome-sandbox ``` +You'll have to do this for every project that uses `@holochain/hc-spin`. + There are other fixes [outlined in the Ubuntu 24.04 release notes](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that can solve the problem; if you'd like to learn more, read through them all and choose the one that feels most appropriate for you. ### Redistributable applications created with [`holochain-kangaroo-electron`](https://github.com/holochain-apps/holochain-kangaroo-electron) are also affected