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.

  1. Install dependencies

    Required:

    Optional (not needed if using Docker Quickstart):

  2. 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
    
  3. Run the dependencies

    docker compose up
    
  4. 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
    
  5. Run the project locally. You will see TLS errors. Those can safely be ignored for now

    deno task start
    
  6. 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”

    image.png

Optional tools