Help Thread: Setting up AMRIT locally (problems, errors & fixes)

[drtechie]

This thread is for anyone setting up AMRIT locally and running into issues.

If you face a problem while following the documentation, please reply here with:

1. What you were trying to do

   • e.g. "Running the backend", "Bringing up Docker containers", "Building the Angular app"

2. Environment details

   • OS (Windows / macOS / Linux + version)
   • Java version
   • Node & npm versions
   • Docker version (if applicable)
   • Database (local / Docker)

3. Steps you followed (short)

   • Link to the doc section (URL)
   • Commands you ran (or screenshots if easier)

4. Error or unexpected behaviour

   • Exact error message/log (or a screenshot)
   • What you expected to happen

5. Anything you already tried

   • e.g. "tried cleaning cache", "reinstalled dependencies", etc.

---

💬 Goal of this thread

• Help new contributors debug setup issues quickly
• Capture common problems so we can improve the docs
• Share workarounds and best practices from the community

If you later find a solution, please reply to your own comment with what fixed it – that will help the next person a lot.

Happy to have you here – thanks for contributing to AMRIT! 🙌