Docker compose for local development

[joiskash]

Local Development Environment to test FHIR sync

Prerequisite

This has been tested on Windows and Ubuntu-Linux. Please install Docker Desktop on windows and the equivalent for Ubuntu .

Steps to run setup on local and connect with android client

Server setup

1. Install Docker Desktop https://www.docker.com/products/docker-desktop
2. Extract this zip
3. Open cmd and cd into the dev directory
4. Run ipconfig and copy your IPv4 Address. It will look something like this IPv4 Address. . . . . . . . . . . : 192.168.0.121
5. Open the data/hapi/application.yaml and edit the line server_address to set the domain to the ip address from the command above.
6. Run docker compose up
7. Check the hapi-fhir-server continer logs from docker desktop, if it throws a cannot connect to db exception, restart it.

Android client setup

1. Install android studio
2. Clone https://github.com/google/android-fhir git clone https://github.com/google/android-fhir
3. Edit the file demo/src/main/res/xml/network_security_config.xml by adding your ip address that you got while setting up the server. Your file will looks something like this

<?xml version="1.0" encoding="utf-8" ?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">hapi.fhir.org</domain>
        <domain includeSubdomains="true">192.168.0.121</domain> # add this line
    </domain-config>
</network-security-config>

4. Edit the file demo/src/main/java/com/google/android/fhir/demo/FhirApplication.kt and change the ServerConfiguration parameter to "http://192.168.0.121:8085/fhir/", make sure you put the CORRECT IP address that you have been using throught this tutorial.
5. Run the "demo" app on your android phone.
6. Create a new patient and make sure the city is answered as NAIROBI.
7. Press sync.

View FHIR resources

To view the FHIR resources you can open a browser and login to http://localhost:8085/ and press history.

View SQL DB

To view the sql DB, you can open your browser and login to http://localhost:8082 use the details below:
System : MySQL
Server : hapi-fhir-mysql:3306
Username : admin
Password : admin