Splitting MacOS and Linux setup instructions through a table

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>