From e07fe096bf53d3e573512110abd172fb2d99f33a Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Thu, 9 Apr 2026 08:52:12 +0200
Subject: [PATCH] sbx: add ubuntu linux installation instructions

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
---
 content/manuals/ai/sandboxes/_index.md      | 11 +++++++++++
 content/manuals/ai/sandboxes/get-started.md | 21 ++++++++++++++++++++-
 2 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/content/manuals/ai/sandboxes/_index.md b/content/manuals/ai/sandboxes/_index.md
index 988f462e138..87fa0fabc09 100644
--- a/content/manuals/ai/sandboxes/_index.md
+++ b/content/manuals/ai/sandboxes/_index.md
@@ -37,6 +37,17 @@ $ sbx login
 > sbx login
 ```
 
+{{< /tab >}}
+{{< tab name="Linux (Ubuntu)" >}}
+
+```console
+$ curl -fsSL https://get.docker.com | sudo REPO_ONLY=1 sh
+$ sudo apt-get install docker-sbx
+$ sudo usermod -aG kvm $USER
+$ newgrp kvm
+$ sbx login
+```
+
 {{< /tab >}}
 {{< /tabs >}}
 
diff --git a/content/manuals/ai/sandboxes/get-started.md b/content/manuals/ai/sandboxes/get-started.md
index 14f2af2c8a2..b5a7ac899cb 100644
--- a/content/manuals/ai/sandboxes/get-started.md
+++ b/content/manuals/ai/sandboxes/get-started.md
@@ -19,12 +19,15 @@ cleaning up.
 
 ## Prerequisites
 
-- macOS (Apple silicon) or Windows (x86_64, Windows 11 required)
+- macOS (Apple silicon), Windows (x86_64, Windows 11 required), or Linux
+  (Ubuntu 22.04 or later, x86_64)
 - If you're on Windows, enable Windows Hypervisor Platform. Open an elevated
   PowerShell prompt (Run as Administrator) and run:
   ```powershell
   Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All
   ```
+- If you're on Linux, your user must be in the `kvm` group for hardware
+  virtualization access.
 - An API key or authentication method for the agent you want to use. Most
   agents require an API key for their model provider (Anthropic, OpenAI,
   Google, and others). See the [agent pages](agents/) for provider-specific
@@ -50,6 +53,22 @@ $ sbx login
 > sbx login
 ```
 
+{{< /tab >}}
+{{< tab name="Linux (Ubuntu)" >}}
+
+```console
+$ curl -fsSL https://get.docker.com | sudo REPO_ONLY=1 sh
+$ sudo apt-get install docker-sbx
+$ sudo usermod -aG kvm $USER
+$ newgrp kvm
+$ sbx login
+```
+
+The first command adds Docker's `apt` repository to your system. The
+`usermod` command grants your user access to `/dev/kvm` for hardware
+virtualization. You need to log out and back in (or use `newgrp`) for the
+group change to take effect.
+
 {{< /tab >}}
 {{< /tabs >}}