diff --git a/README.md b/README.md
index e6b0c6f8..34be79a1 100644
--- a/README.md
+++ b/README.md
@@ -301,7 +301,7 @@ sudo apt install archivebox
mkdir -p ~/archivebox/data
cd ~/archivebox/data
archivebox init
-archivebox install
+sudo archivebox install
archivebox add 'https://example.com'
@@ -315,7 +315,7 @@ archivebox help
See below for more usage examples using the CLI, Web UI, or filesystem/SQL/Python to manage your archive.
-The apt package is a thin dev-channel wrapper around the normal Python install flow. See the debian-archivebox repo for details, and run sudo archivebox install only if you want it to install missing system packages via apt.
+The apt package is a thin dev-channel wrapper around the normal Python install flow. sudo archivebox install uses apt for missing system dependencies while preserving ownership of the user-owned collection. See the debian-archivebox repo for details.
diff --git a/docs/Install.md b/docs/Install.md
index 2c2e40d1..213f2962 100644
--- a/docs/Install.md
+++ b/docs/Install.md
@@ -146,15 +146,15 @@ sudo apt install archivebox
mkdir -p ~/archivebox/data
cd ~/archivebox/data
archivebox init
-archivebox install
+sudo archivebox install
archivebox add 'https://example.com'
```
The apt package is a thin dev-channel wrapper around the normal Python install
flow. Runtime extractor
dependencies such as Chromium, yt-dlp, SingleFile, and other plugin-managed
-tools are installed by `archivebox install`; use `sudo archivebox install` only
-if you want it to install missing system packages via apt.
+tools are installed by `sudo archivebox install`, which uses apt for missing
+system dependencies while preserving ownership of the user-owned collection.
Alternatively, install with `uv`:
diff --git a/docs/codeblocks.toml b/docs/codeblocks.toml
index ae89836c..666fd0cd 100644
--- a/docs/codeblocks.toml
+++ b/docs/codeblocks.toml
@@ -16,7 +16,7 @@ version = 2
"d5ae3240405670bb-1" = "run"
"588be84a1f0fda9a-1" = "illustration"
"a7a123ba522227be-1" = "run"
-"fcdd073a5440f5ca-1" = "run"
+"25788feae93a3e48-1" = "run"
"588be84a1f0fda9a-2" = "illustration"
"8fe4a2c15abb0ab2-1" = "run"
"2b08779e4d24d305-1" = "run"
@@ -130,7 +130,7 @@ version = 2
"662be0691524555c-1" = "illustration"
"c8df632a4f4e3100-1" = "run"
"4d29a8d4b3902ab3-1" = "run"
-"73f9f36a369f2398-1" = "run"
+"5ce9896b6807dc52-1" = "run"
"b92d8bdeb23143fc-1" = "illustration"
"311abf57a4443a9e-1" = "illustration"
"fcaf2b90e39272df-1" = "run"
@@ -259,7 +259,7 @@ version = 2
"39bc0d99ed165be2-1" = "system"
"d5ae3240405670bb-1" = "collection"
"a7a123ba522227be-1" = "system"
-"fcdd073a5440f5ca-1" = "system"
+"25788feae93a3e48-1" = "system"
"8fe4a2c15abb0ab2-1" = "system"
"2b08779e4d24d305-1" = "system"
"6392c7b5f3593d07-1" = "collection"
@@ -299,7 +299,7 @@ version = 2
"8d86727108f1dbad-1" = "docker"
"c8df632a4f4e3100-1" = "system"
"4d29a8d4b3902ab3-1" = "system"
-"73f9f36a369f2398-1" = "system"
+"5ce9896b6807dc52-1" = "system"
"fcaf2b90e39272df-1" = "system"
"77b61fd52c4c3c32-1" = "collection"
"a8f16f6be4f2b3c0-1" = "collection"
@@ -339,7 +339,7 @@ version = 2
"39bc0d99ed165be2-1" = "ubuntu"
"d5ae3240405670bb-1" = "ubuntu"
"a7a123ba522227be-1" = "root"
-"fcdd073a5440f5ca-1" = "root"
+"25788feae93a3e48-1" = "root"
"8fe4a2c15abb0ab2-1" = "macos"
"2b08779e4d24d305-1" = "macos"
"6392c7b5f3593d07-1" = "ubuntu"
@@ -379,7 +379,7 @@ version = 2
"8d86727108f1dbad-1" = "docker"
"c8df632a4f4e3100-1" = "macos"
"4d29a8d4b3902ab3-1" = "macos"
-"73f9f36a369f2398-1" = "root"
+"5ce9896b6807dc52-1" = "root"
"fcaf2b90e39272df-1" = "ubuntu"
"77b61fd52c4c3c32-1" = "ubuntu"
"a8f16f6be4f2b3c0-1" = "ubuntu"