Updated "tips" page with CLIENT_MUTE advice. (#1720)

* Updated "tips" page with client_mute advice.

* Update docs/configuration/tips.mdx

Co-authored-by: Tommy Ekstrand <tekstrand@users.noreply.github.com>

* Update docs/configuration/tips.mdx

Co-authored-by: Tommy Ekstrand <tekstrand@users.noreply.github.com>

* Update docs/configuration/tips.mdx

Co-authored-by: Tommy Ekstrand <tekstrand@users.noreply.github.com>

* Update docs/configuration/tips.mdx

Co-authored-by: Tommy Ekstrand <tekstrand@users.noreply.github.com>

* Update docs/configuration/tips.mdx

Co-authored-by: Tommy Ekstrand <tekstrand@users.noreply.github.com>

* Fixes based on suggestions in the PR.

* Fixed per https://github.com/meshtastic/meshtastic/pull/1720#discussion_r1957434228

* Fixed typo.

* Make heading more concise.

* Update docs/configuration/tips.mdx

---------

Co-authored-by: Tommy Ekstrand <tekstrand@users.noreply.github.com>
This commit is contained in:
David Andrzejewski 2025-02-16 18:14:29 -05:00 committed by GitHub
parent 58b731c761
commit 2e324b040b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -8,12 +8,18 @@ sidebar_position: 4
## Roles
It is strongly recommended to keep your [ROLE](/docs/configuration/radio/device#roles) set to `CLIENT`. Only change this if you have a specific, well-understood reason to do so.
It is strongly recommended to keep your [ROLE](/docs/configuration/radio/device#roles) set to `CLIENT` or `CLIENT_MUTE`. Only use other roles if you have a specific, well-understood reason to do so. Read our [blog post about choosing the best role](/blog/choosing-the-right-device-role/).
### Why `CLIENT` is Recommended
### Recommended Roles
- `CLIENT` nodes efficiently repeat and route packets as needed.
- They use smart delays for rebroadcasting, improving network stability.
- `CLIENT` nodes efficiently repeat and route packets as needed.
- **Almost always the correct mode.**
- Uses smart delays for rebroadcasting, improving network stability.
- Use for "rooftop" or other nodes that enhance your mesh.
- Use during isolated activities such as hiking, skiing, or MTB where you're in an area with few nodes.
- `CLIENT_MUTE` nodes behave as above but do not repeat packets.
- Use for personal nodes that are in range of a higher-profile node in a dense or congested mesh.
- Use when you have multiple nodes in close proximity (set your "best-placed" node to `CLIENT`).
![Client Node Example](/img/configuration/client.webp)
*One example of a 'Client' node. Photo credit: Cully@KBOXLABS*