From 2e324b040b7ec0f26e1b95bd334dc4d0942259af Mon Sep 17 00:00:00 2001 From: David Andrzejewski Date: Sun, 16 Feb 2025 18:14:29 -0500 Subject: [PATCH] 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 * Update docs/configuration/tips.mdx Co-authored-by: Tommy Ekstrand * Update docs/configuration/tips.mdx Co-authored-by: Tommy Ekstrand * Update docs/configuration/tips.mdx Co-authored-by: Tommy Ekstrand * Update docs/configuration/tips.mdx Co-authored-by: Tommy Ekstrand * 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 --- docs/configuration/tips.mdx | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/configuration/tips.mdx b/docs/configuration/tips.mdx index 13dac4dc..66ce7276 100644 --- a/docs/configuration/tips.mdx +++ b/docs/configuration/tips.mdx @@ -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*