23 files changed, 171 insertions, 3 deletions
diff --git a/docs/ar-SA/faq/README.md b/docs/ar-SA/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/ar-SA/faq/README.md
+++ b/docs/ar-SA/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/bn-BD/faq/README.md b/docs/bn-BD/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/bn-BD/faq/README.md
+++ b/docs/bn-BD/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/ckb-IR/faq/README.md b/docs/ckb-IR/faq/README.md
index b86e8a5f1..34bac692b 100644
--- a/docs/ckb-IR/faq/README.md
+++ b/docs/ckb-IR/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/de-DE/faq/README.md b/docs/de-DE/faq/README.md
index ce856da8f..49cb16931 100644
--- a/docs/de-DE/faq/README.md
+++ b/docs/de-DE/faq/README.md
@@ -120,3 +120,11 @@ Wenn Starship mit Hilfe des Installationsscripts installiert wurde, entfernt der
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/es-ES/faq/README.md b/docs/es-ES/faq/README.md
index e536bfb06..01c3d0369 100644
--- a/docs/es-ES/faq/README.md
+++ b/docs/es-ES/faq/README.md
@@ -120,3 +120,11 @@ Si Starship fue instalado usando el guión de instalación, el siguiente comando
 # Localiza y elimina el binario de starship
 sh -c 'rm "$(comando -v 'starship')"'
 ```
+
+## ¿Cómo instalo Starship sin `sudo`?
+
+El script de instalación del shell (`https://starship.rs/install.sh`) solo intenta usar `sudo` si el directorio de instalación no es escribible para el usuario actual. El directorio de instalación por defecto es el valor de la variable de entorno `$BIN_DIR` o `/usr/local/bin` si `$BIN_DIR` no está establecido. Si en su lugar establece el directorio de instalación a uno que tenga permisos de escritura para su usuario, deberías ser capaz de instalar starship sin `sudo`. Por ejemplo, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` usa la opción de línea de comando `b` del script de instalación para establecer el directorio de instalación a `~/.local/bin`.
+
+Para una instalación no interactiva de Starship, no te olvides de añadir la opción `y` para omitir la confirmación. Consulte la fuente del script de instalación para ver una lista de todas las opciones de instalación soportadas.
+
+Al usar el gestor de paquetes, vea la documentación de su gestor de paquetes acerca de instalación con o sin `sudo`.
diff --git a/docs/fr-FR/advanced-config/README.md b/docs/fr-FR/advanced-config/README.md
index bb090d084..28cfcfd91 100644
--- a/docs/fr-FR/advanced-config/README.md
+++ b/docs/fr-FR/advanced-config/README.md
@@ -205,7 +205,7 @@ Certains shells peuvent gérer une invite de commande à droite, sur la même li
 
 Note: l’invite à droite est une seule ligne, sur la même ligne que l’entrée. Pour aligner à droite les modules au-dessus de la ligne d’entrée d’une invite multiligne, voir le [module `fill`](/config/#fill).
 
-`right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell.
+`right_format` est actuellement supporté pour les shells suivants : elvish, fish, zsh, xonsh, cmd, nushell.
 
 ### Exemple
 
diff --git a/docs/fr-FR/faq/README.md b/docs/fr-FR/faq/README.md
index 65066f8fa..c7b201be8 100644
--- a/docs/fr-FR/faq/README.md
+++ b/docs/fr-FR/faq/README.md
@@ -80,7 +80,7 @@ env STARSHIP_LOG=trace starship timings
 
 Cela affichera le journal de suivi et un détail de tous les modules qui ont soit pris plus d’1ms pour s’exécuter, soit affiché quelque chose.
 
-Finally if you find a bug you can use the `bug-report` command to create a GitHub issue.
+Enfin, si vous trouvez un bug, vous pouvez utiliser la commande `bug-report` pour créer un ticket sur GitHub.
 
 ```sh
 starship bug-report
@@ -120,3 +120,11 @@ Si Starship a été installé en utilisant le script d'installation, la commande
 # Trouver et supprimer le binaire starship
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/fr-FR/guide/README.md b/docs/fr-FR/guide/README.md
index 781d03bd3..810104794 100644
--- a/docs/fr-FR/guide/README.md
+++ b/docs/fr-FR/guide/README.md
@@ -35,7 +35,7 @@
   <a href="https://stand-with-ukraine.pp.ua"
     ><img
       src="https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraineFlat.svg"
-      alt="Stand With Ukraine"
+      alt="Soutenez l'Ukraine"
  /></a>
 </p>
 
diff --git a/docs/id-ID/faq/README.md b/docs/id-ID/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/id-ID/faq/README.md
+++ b/docs/id-ID/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/it-IT/faq/README.md b/docs/it-IT/faq/README.md
index 24c8cb702..00dc751ea 100644
--- a/docs/it-IT/faq/README.md
+++ b/docs/it-IT/faq/README.md
@@ -120,3 +120,11 @@ Se Starship è stato installato utilizzando lo script di installazione, il segue
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/ja-JP/faq/README.md b/docs/ja-JP/faq/README.md
index 6a8bb91ee..7b3b84b1f 100644
--- a/docs/ja-JP/faq/README.md
+++ b/docs/ja-JP/faq/README.md
@@ -120,3 +120,11 @@ Starship をインストールスクリプトを使用してインストール�
 # starshipのバイナリを見つけて削除
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/ko-KR/faq/README.md b/docs/ko-KR/faq/README.md
index 1cd79ec31..0e7a3de84 100644
--- a/docs/ko-KR/faq/README.md
+++ b/docs/ko-KR/faq/README.md
@@ -120,3 +120,11 @@ Starship을 설치 스크립트로 설치하였다면 바이너리 파일 제거
 # starship 바이너리 파일을 찾고 제거합니다.
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/nl-NL/faq/README.md b/docs/nl-NL/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/nl-NL/faq/README.md
+++ b/docs/nl-NL/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/no-NO/faq/README.md b/docs/no-NO/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/no-NO/faq/README.md
+++ b/docs/no-NO/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/pl-PL/faq/README.md b/docs/pl-PL/faq/README.md
index 4df19d6bc..2757bc7b6 100644
--- a/docs/pl-PL/faq/README.md
+++ b/docs/pl-PL/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/pt-BR/faq/README.md b/docs/pt-BR/faq/README.md
index 27259e572..c445f797d 100644
--- a/docs/pt-BR/faq/README.md
+++ b/docs/pt-BR/faq/README.md
@@ -120,3 +120,11 @@ Se o Starship foi instalado usando o script de instalação, o comando abaixo ir
 # Localiza e exclui o binário do starship
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/pt-PT/faq/README.md b/docs/pt-PT/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/pt-PT/faq/README.md
+++ b/docs/pt-PT/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/ru-RU/faq/README.md b/docs/ru-RU/faq/README.md
index f3f1992d6..6fe2f96c7 100644
--- a/docs/ru-RU/faq/README.md
+++ b/docs/ru-RU/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/tr-TR/faq/README.md b/docs/tr-TR/faq/README.md
index 41bb2d391..1f8484406 100644
--- a/docs/tr-TR/faq/README.md
+++ b/docs/tr-TR/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/uk-UA/faq/README.md b/docs/uk-UA/faq/README.md
index 2d1f9fd2f..afdb13d6b 100644
--- a/docs/uk-UA/faq/README.md
+++ b/docs/uk-UA/faq/README.md
@@ -120,3 +120,11 @@ Starship так само легко видалити, як і встановит
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/vi-VN/faq/README.md b/docs/vi-VN/faq/README.md
index 9af777e5b..04983a2de 100644
--- a/docs/vi-VN/faq/README.md
+++ b/docs/vi-VN/faq/README.md
@@ -120,3 +120,11 @@ If Starship was installed using the install script, the following command will d
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/zh-CN/faq/README.md b/docs/zh-CN/faq/README.md
index ece4a97e9..9d21b2225 100644
--- a/docs/zh-CN/faq/README.md
+++ b/docs/zh-CN/faq/README.md
@@ -120,3 +120,11 @@ Starship 的卸载过程与安装过程一样简单。
 # 找到并且删除 Starship 二进制文件
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
diff --git a/docs/zh-TW/faq/README.md b/docs/zh-TW/faq/README.md
index 372f6d5ba..f19960c72 100644
--- a/docs/zh-TW/faq/README.md
+++ b/docs/zh-TW/faq/README.md
@@ -120,3 +120,11 @@ echo -e "\xee\x82\xa0"
 # Locate and delete the starship binary
 sh -c 'rm "$(command -v 'starship')"'
 ```
+
+## How do I install Starship without `sudo`?
+
+The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
+
+For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
+
+When using a package manager, see the documentation for your package manager about installing with or without `sudo`.