Skip to content

docs: stop hardcoding the default PSK and preset names #32

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rancur wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: stop hardcoding the default PSK and preset names #32

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 3 additions & 4 deletions docs/docs/suggested_channels.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Pick your platform below. The flow is the same idea everywhere: open the Meshtas
find the **Channels** editor, add a channel, and enter the **Name** and **Key** from the
[table further down](#the-channels) exactly as written.

???+ note "Android"
??? note "Android"

1. Open the **Meshtastic** app and make sure your node is connected over Bluetooth.
2. Tap the **Settings** tab, then open **Channels**.
Expand All @@ -39,7 +39,7 @@ find the **Channels** editor, add a channel, and enter the **Name** and **Key**
6. Leave **Uplink/Downlink** at their defaults unless you have a reason to change them.
7. Tap **Save** / the send button to write the channel to your node.

> To use **MediumFast** as your primary channel, you can leave the primary channel's
> To use the default preset as your primary channel, you can leave the primary channel's
> name **blank**. An empty primary name is the `default` channel.

??? note "iOS / iPadOS / macOS"
Expand All @@ -54,7 +54,7 @@ find the **Channels** editor, add a channel, and enter the **Name** and **Key**
6. Enter the **Key** (PSK) from the table exactly as written.
7. Tap **Save**, then make sure you **send the configuration** back to your node.

> To use **MediumFast** as your primary channel, you can leave the primary channel's
> To use the default preset as your primary channel, you can leave the primary channel's
> name **blank**. An empty primary name is the `default` channel.

??? note "Other (Web Client / Apple Watch / CLI)"
Expand Down Expand Up @@ -93,7 +93,6 @@ see every column.

| Channel Name (case sensitive) | Key | Size (iOS only) | Description |
|:------------------------------|:----|:----------------|:------------|
| `MediumFast` | `AQ==` | Default | The default primary MediumFast channel. Name can also be left blank. |
| `azmsh` | `AQ==` | Default | The Arizona channel, great for running tests and general chatter. |
| `Weather` | `Ww==` | 1-byte | Users post from their weather stations on their roofs, great for checking the weather every hour and making sure your node is consistently receiving. |
| `Traffic` | `TQ==` | 1-byte | Local traffic reports along with waypoints showing where there is traffic on the map. |
Expand Down
8 changes: 4 additions & 4 deletions docs/privacy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ A typical packet travels like this:
2. A node on the mesh that is connected to MQTT relays that packet to an MQTT
broker.
3. Our ingestion tool reads the packet from the broker and decodes it using the
public default key (AQ==).
well-known public default key that ships with every Meshtastic device.
4. The decoded data is shown in our tools, such as view.azmsh.net.

Our broker is set up for uploads only. Nodes can send data to it, but downlink is
Expand All @@ -95,9 +95,9 @@ changes how your node behaves.**
## Important: public-channel data is not private

Meshtastic's standard channels are secured only with a default encryption key
(AQ==) that ships with every device and is publicly known. This is not unique to
one channel. The same default key is used by the common presets, such as LongFast
and MediumFast, whenever a channel is left on the default key. Because that key is
that ships with every device and is publicly known. This is not unique to
one channel. The same default key is used by the common modem presets whenever a
channel is left on the default key. Because that key is
public, anyone running Meshtastic can read traffic that uses it. It is not
private, even though it is technically "encrypted."

Expand Down