These instructions are written for a Mac setup. All tools listed should be installable or have alternatives on Windows/Linux, but the steps might be different from those listed.
Install dependencies
Required:
git lfs install && git lfs pull ← can’t be skipped, you need the source files from SNOMED!Optional (not needed if using Docker Quickstart):
Clone the repository.
https://github.com/Virtual-Hospitals-Africa/virtual-hospitals-africa
git clone [email protected]:Virtual-Hospitals-Africa/virtual-hospitals-africa.git --recursive && cd virtual-hospitals-africa
Run the dependencies
docker compose up
Run ./setup.sh. If you missed any dependencies or are running Windows you may need to follow the steps manually to create the .env files correctly
./setup.sh
Run the project locally. You will see TLS errors. Those can safely be ignored for now
deno task start
Access the application at https://localhost:8000. Click the top right to sign in. You may see a warning about certificates. In that case click “Advanced > Proceed to localhost”

If running with the docker setup, adminer will be running on http://localhost:8888 and you’ll see connection info printed to the console

Dedicated clients include Postico for Mac, PgAdmin for Mac & Windows, DataGrip (macOS and Windows), TablePlus (all OS)