docs: add notice for ubuntu 23.10+ (#20)

darkyzhou · Feb 2, 2025 · cb56412 · cb56412
1 parent 3a82592
commit cb56412
Show file tree

Hide file tree

Showing 5 changed files with 2,511 additions and 1,443 deletions.
diff --git a/docs/next.config.js → docs/next.config.mjs b/docs/next.config.js → docs/next.config.mjs
@@ -1,12 +1,13 @@
-const withNextra = require("nextra")({
+import nextra from 'nextra'
+
+const withNextra = nextra({
   theme: "nextra-theme-docs",
   themeConfig: "./theme.config.jsx",
-});
+})
 
-module.exports = withNextra({
+export default withNextra({
   i18n: {
     locales: ["zh", "en"],
     defaultLocale: "zh",
-    localeDetection: true,
   },
 });
diff --git a/docs/package.json b/docs/package.json
@@ -4,13 +4,13 @@
     "private": true,
     "scripts": {},
     "dependencies": {
-        "next": "^13.4.3",
-        "nextra": "^2.5.2",
-        "nextra-theme-docs": "^2.5.2",
-        "react": "^18.2.0",
-        "react-dom": "^18.2.0"
+        "next": "13.5.8",
+        "nextra": "2.13.4",
+        "nextra-theme-docs": "2.13.4",
+        "react": "18.3.1",
+        "react-dom": "18.3.1"
     },
     "devDependencies": {
         "@opentelemetry/api": "^1.4.1"
     }
-}
+}
diff --git a/docs/pages/getting-started.en.mdx b/docs/pages/getting-started.en.mdx
@@ -28,6 +28,24 @@ The installation steps below assume the use of the `seele` user and group, with
 
 </Callout>
 
+<Callout type="warning">
+
+If you're using Ubuntu 23.10 or later, you may need to add the following to `/etc/sysctl.conf`:
+
+```sh
+kernel.apparmor_restrict_unprivileged_userns=0
+```
+
+Or run:
+
+```sh
+sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
+```
+
+Reference article: [Restricted unprivileged user namespaces are coming to Ubuntu 23.10](https://ubuntu.com/blog/ubuntu-23-10-restricted-unprivileged-user-namespaces)
+
+</Callout>
+
 ## Installation Steps
 
 Seele supports running in various environments, including bare-metal deployment, Docker deployment, and Kubernetes deployment, with Docker deployment being the simplest method.

diff --git a/docs/pages/getting-started.zh.mdx b/docs/pages/getting-started.zh.mdx
@@ -28,6 +28,24 @@ adduser --no-create-home --disabled-login --disabled-password --gecos "" seele
 
 </Callout>
 
+<Callout type="warning">
+
+若您使用 Ubuntu 23.10 或更高版本，您可能需要在 `/etc/sysctl.conf` 中添加以下内容：
+
+```sh
+kernel.apparmor_restrict_unprivileged_userns=0
+```
+
+或执行：
+
+```sh
+sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
+```
+
+参考文章：[Restricted unprivileged user namespaces are coming to Ubuntu 23.10](https://ubuntu.com/blog/ubuntu-23-10-restricted-unprivileged-user-namespaces)
+
+</Callout>
+
 ## 安装步骤
 
 Seele 支持在多种环境下运行，包括裸机部署、Docker 部署和 Kubernetes 部署，最简单的方式是 Docker 部署。