Skip to content

Create FAQ.md for AegisAI troubleshooting #984#985

Open
Yugal0708 wants to merge 1 commit into
SdSarthak:mainfrom
Yugal0708:docs/add-faq-troubleshooting
Open

Create FAQ.md for AegisAI troubleshooting #984#985
Yugal0708 wants to merge 1 commit into
SdSarthak:mainfrom
Yugal0708:docs/add-faq-troubleshooting

Conversation

@Yugal0708

Copy link
Copy Markdown

Summary

Closes #984

Added docs/FAQ.md covering 6 common setup issues that new contributors
and users face when running AegisAI locally.

What's included

  • Backend startup failure due to missing .env
  • Ollama LLM_API_KEY configuration
  • PostgreSQL connection refused fix
  • Frontend blank page / API error fix
  • Python version mismatch (< 3.11)
  • Docker Compose port conflict fix

Format followed

Each entry: Problem → Cause → Fix with code blocks where needed.

Files changed

  • docs/FAQ.md — new file (docs-only, no code touched)

GSSoC 2026 contribution — open to feedback and changes!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add FAQ and Troubleshooting guide for common setup errors

1 participant