From fc8ba9aba9598a21124a61df778017cdf9678774 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 24 May 2024 09:33:14 -0700 Subject: [PATCH] tiny changes to ubuntu guidance --- src/pages/get-started/2-hello-world.md | 2 +- src/pages/get-started/3-forum-app-tutorial.md | 2 +- src/pages/get-started/install-advanced.md | 4 +++- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/src/pages/get-started/2-hello-world.md b/src/pages/get-started/2-hello-world.md index b2bc09194..c89371017 100644 --- a/src/pages/get-started/2-hello-world.md +++ b/src/pages/get-started/2-hello-world.md @@ -32,7 +32,7 @@ npm install ``` !!! info "Warning for Ubuntu 24.04 and later -Ubuntu Linux 24.04 [introduces security policy changes](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that cause the next command to fail. Here's a simple fix. In your terminal, run this command: +Ubuntu Linux 24.04 [introduces security policy changes](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that cause the following command to fail. Here's a simple fix. In your terminal, run this command: ```shell chmod 4755 node_modules/electron/dist/chrome-sandbox && sudo chown root:root node_modules/electron/dist/chrome-sandbox diff --git a/src/pages/get-started/3-forum-app-tutorial.md b/src/pages/get-started/3-forum-app-tutorial.md index 3c6bc5ac0..22001f43a 100644 --- a/src/pages/get-started/3-forum-app-tutorial.md +++ b/src/pages/get-started/3-forum-app-tutorial.md @@ -796,7 +796,7 @@ Before you get started editing the UI, it's helpful to be able to actually run t ## 8. Run your application in dev mode !!! info "Warning for Ubuntu 24.04 and later -Ubuntu Linux 24.04 [introduces security policy changes](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that cause the next command to fail. Here's a simple fix. In your terminal, run this command: +Ubuntu Linux 24.04 [introduces security policy changes](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#unprivileged-user-namespace-restrictions-15) that cause the following command to fail. Here's a simple fix. In your terminal, run this command: ```shell chmod 4755 node_modules/electron/dist/chrome-sandbox && sudo chown root:root node_modules/electron/dist/chrome-sandbox diff --git a/src/pages/get-started/install-advanced.md b/src/pages/get-started/install-advanced.md index e3b02adea..44f296309 100644 --- a/src/pages/get-started/install-advanced.md +++ b/src/pages/get-started/install-advanced.md @@ -271,9 +271,11 @@ rm ~/.nix-profile 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: +::: output-block ``` [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. ``` +::: You can fix the issue by entering the following command in your project's root directory: @@ -281,7 +283,7 @@ You can fix the issue by entering the following command in your project's root d 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`. +You'll have to do this for every hApp 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.