Skip to content

Commit

Permalink
Add a prerequisite section in the README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
kdaud committed Mar 15, 2023
1 parent 5950252 commit cb05cc8
Showing 1 changed file with 10 additions and 25 deletions.
35 changes: 10 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,14 @@ Docker Compose project to run Bahmni.
<img src="./readme/vertical-logo-monochromatic.png" alt="Docker Logo" height="150">
</p>

### Run Ozone FOSS locally

#### Prerequisites
Install Git, Maven and Docker Compose

#### For Linux OS
Create the docker group and add your user to it. Checkout the guide [here](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).

## Quick Start

### Create your working directory:
Expand All @@ -19,7 +27,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:
Expand Down Expand Up @@ -64,35 +72,12 @@ export EIP_CONFIG_PATH=$DISTRO_PATH/eip_config

The complete list of available variables can be found in [.env](.env).

### Move to the location of bahmni-docker-compose project

```bash
cd $BAHMNI_DIR/bahmni-docker-compose-$VERSION
```

### Start Bahmni:

<table>
<tr>
<td> macOS </td> <td> Linux </td>
</tr>
<tr>
<td>

```bash
docker compose -p $DISTRO_GROUP up
```

</td>
<td>

```bash
sudo -E docker compose -p $DISTRO_GROUP up
```
</td>
</tr>
</table>

<p align="center">
<img src="./readme/docker-compose-up-shadow.png" alt="docker-compose up" height="200">
</p>
Expand Down Expand Up @@ -262,7 +247,7 @@ watch rsync -av ~/repos/openmrs-module-bahmniapps/ui/ /tmp/bahmni-distro-haiti/b

### Debug the Java apps

The Java apps (OpenMRS, Bahmni Reports, Odoo Connect...) can be remote debugged very simply by setting a the `DEBUG: "true"` environment variable to the service.
The Java apps (OpenMRS, Bahmni Reports, Odoo Connect...) can be remote debugged very simply by setting a `DEBUG: "true"` environment variable to the service.

Don't forget to open the port `8000` on the service as well:
Eg:
Expand Down

0 comments on commit cb05cc8

Please sign in to comment.