search

medic / cht-docs

Documentation site for the Community Health Tookit
https://docs.communityhealthtoolkit.org
14 stars 18 forks source link

Improve 'CHT Local Environment Setup' #620

Open kawerewagaba opened 2 years ago

kawerewagaba commented 2 years ago

Page: /apps/tutorials/local-setup/ Version: 2021-12-01 13:39:24 -0600 -0600

Installing a valid TLS certificate is not optional for "normal" users (such as a Nurse) - it is a requirement. The application otherwise does not work.

Screenshot 2022-01-27 at 14 58 51 Screenshot 2022-01-27 at 15 03 41
kawerewagaba commented 2 years ago

I followed the tutorial to install one, but I need to add some key instructions that I believe may have been overlooked!

For context, I'm developing on macOS Mojave 10.14.5.

After running the script to install the certificate (as shown in the tutorial) do the following:

  1. Run ifconfig | grep inet to get your local IP address - most likely starts with 192.168....
  2. Reload your application (cd into the desired project e.g itech-aurum) and run the config with an updated url: cht --url=https://medic:password@192-168-1-171.my.local-ip.co:8443. DO NOT FORGET TO APPEND THE PORT THE APPLICATION IS LOCALLY LISTENING ON: 8443 in my case.
  3. Update the browser url from localhost: https://192-168-1-171.my.local-ip.co:8443.

With those additional steps, you should be good to go.