From 5f85fe6684c54cd76da2c5a77862b04e16820754 Mon Sep 17 00:00:00 2001
From: kdaud <dkakumirizii@gmail.com>
Date: Mon, 6 Mar 2023 10:38:21 +0300
Subject: [PATCH] Splitting MacOS and Linux setup instructions through a table

---
 README.md | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 433e102..fe782f5 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ cd ~/
 Then create the working directory and save the path:
 ```
 export BAHMNI_DIR=$PWD/bahmni && \
-mkdir $BAHMNI_DIR
+mkdir $BAHMNI_DIR && cd $BAHMNI_DIR
 ```
 
 ### Download the Docker Compose project itself:
@@ -66,10 +66,29 @@ The complete list of available variables can be found in [.env](.env).
 
 ### Start Bahmni:
 
+<table>
+<tr>
+<td> macOS </td> <td> Linux </td>
+</tr>
+<tr>
+<td>
+
+```bash
+docker compose -p $DISTRO_GROUP up
 ```
-cd $BAHMNI_DIR/bahmni-docker-compose-$VERSION && \
-docker-compose -p $DISTRO_GROUP up
+
+</td>
+<td>
+
+```bash
+sudo -E docker compose -p $DISTRO_GROUP up
 ```
+</td>
+</tr>
+</table>
+
+**Note:** On Linux we advise to run `docker` with `sudo -E` option to preserve the user environment as `su`. See also ['Post-installation steps for Linux'](https://docs.docker.com/engine/install/linux-postinstall/) for more details.
+
 <p align="center">
 <img src="./readme/docker-compose-up-shadow.png" alt="docker-compose up" height="200">
 </p>