diff --git a/docs/development/setup-recommended.md b/docs/development/setup-recommended.md
index f2af47c5c1..8931565ba9 100644
--- a/docs/development/setup-recommended.md
+++ b/docs/development/setup-recommended.md
@@ -754,6 +754,10 @@ WSL instance) is also usually helpful.
 
 ```
 
+```{include} setup/unix-troubleshoot.md
+
+```
+
 #### Vagrant was unable to mount VirtualBox shared folders
 
 For the following error:
@@ -780,20 +784,6 @@ $ vagrant up
 to reboot the guest. After this, you can do `vagrant provision` and
 `vagrant ssh`.
 
-#### Unmet dependencies error
-
-When running `vagrant up` or `provision`, if you see the following error:
-
-```console
-==> default: E:unmet dependencies. Try 'apt-get -f install' with no packages (or specify a solution).
-```
-
-It means that your local apt repository has been corrupted, which can
-usually be resolved by executing the command:
-
-```console
-$ apt-get -f install
-```
 
 #### os.symlink error
 
diff --git a/docs/development/setup/unix-troubleshoot.md b/docs/development/setup/unix-troubleshoot.md
new file mode 100644
index 0000000000..7130d08664
--- /dev/null
+++ b/docs/development/setup/unix-troubleshoot.md
@@ -0,0 +1,14 @@
+#### Unmet dependencies error
+
+When running `vagrant up` or `provision`, if you see the following error:
+
+```console
+==> default: E:unmet dependencies. Try 'apt-get -f install' with no packages (or specify a solution).
+```
+
+It means that your local apt repository has been corrupted, which can
+usually be resolved by executing the command:
+
+```console
+$ apt-get -f install
+```