From 21bf16317c4acece6c498365d1229e4dab65031f Mon Sep 17 00:00:00 2001
From: "Nico (sqc)" <73706793+nicosqc@users.noreply.github.com>
Date: Tue, 3 Jan 2023 12:27:06 +0100
Subject: [PATCH] docs: run bash explicitly with sudo -i

Since the default shell is set to /bin/sh, running 'source' to load the virtualenv won't work right away as described in the docs. You need to start bash (or a compatible shell) since sh does not feature the 'source' builtin. This addresses modoboa/modoboa-installer#463
---
 doc/installation.rst |  2 +-
 doc/moving.rst       |  2 +-
 doc/upgrade.rst      | 10 +++++-----
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/installation.rst b/doc/installation.rst
index bc06a3389..17aa1aace 100644
--- a/doc/installation.rst
+++ b/doc/installation.rst
@@ -78,7 +78,7 @@ use them:
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtuenv_path>/bin/activate
 
 Then, run the following commands:
diff --git a/doc/moving.rst b/doc/moving.rst
index f86338bac..6f8bdb636 100644
--- a/doc/moving.rst
+++ b/doc/moving.rst
@@ -41,7 +41,7 @@ To actually import such a file:
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtualenv_path>/bin/activate
    > cd <modoboa_instance_dir>
    > python manage.py modo import <your file>
diff --git a/doc/upgrade.rst b/doc/upgrade.rst
index 403042fca..9c8b310d1 100644
--- a/doc/upgrade.rst
+++ b/doc/upgrade.rst
@@ -20,7 +20,7 @@ use them:
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtuenv_path>/bin/activate
 
 Then, run the following commands:
@@ -62,7 +62,7 @@ use them:
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtuenv_path>/bin/activate
 
 Then, run the following commands:
@@ -605,7 +605,7 @@ Remove ``django-passwords`` from your system:
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtuenv_path>/bin/activate
    > pip uninstall django-passwords
 
@@ -743,7 +743,7 @@ If you used 1.7.0 for a fresh installation, please run the following commands:
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtuenv_path>/bin/activate
    > cd <modoboa_instance_dir>
    > python manage.py load_initial_data
@@ -846,7 +846,7 @@ Run the following commands (load virtualenv if you use one):
 
 .. sourcecode:: bash
 
-   > sudo -u <modoboa_user> -i
+   > sudo -u <modoboa_user> -i bash
    > source <virtuenv_path>/bin/activate
    > cd <modoboa_instance_dir>
    > python manage.py migrate