---
summary: "Help hub: common fixes, install sanity, and where to look when something breaks"
read_when:
  - You are new and want a "what do I click/run" guide
  - Something broke and you want the fastest path to a fix
title: "Help"
---

Quick "get unstuck" path for the most common problems:

- [Troubleshooting](/help/troubleshooting) - symptom-first decision tree
- [Debugging](/help/debugging) - watch mode, raw streams, dev profile
- [Install sanity](/install/node#troubleshooting) - Node / npm / PATH checks
- [Gateway troubleshooting](/gateway/troubleshooting) - gateway-specific issues
- [Doctor](/gateway/doctor) - automated repair + diagnostic bundle

## FAQ

- [FAQ](/help/faq) - day-to-day concepts and operational questions
- [First-run FAQ](/help/faq-first-run) - install, onboard, auth, subscriptions, early failures
- [Models FAQ](/help/faq-models) - model selection, failover, auth profiles

## Diagnostics

- [Environment variables](/help/environment) - where Nodmix loads env vars and precedence
- [Diagnostics flags](/diagnostics/flags) - runtime diagnostics and verbose modes
- [Node + tsx crash](/debug/node-issue) - specific Node / tsx runtime crash scenarios

## Testing

- [Testing](/help/testing) - test suites and Docker runners
- [Update and plugin tests](/help/testing-updates-plugins) - package update, migration, and plugin install validation
- [Live tests](/help/testing-live) - network-touching provider and CLI smokes

## Community and meta

- [Nodmix lore](/start/lore) - the story
- [Docs hubs](/start/hubs) - how this documentation is organized
- [Docs directory](/start/docs-directory) - full file map
