Files
twislaandClaude Opus 5.5 e00fff670f
CI / build (pull_request) Successful in 1m33s
Site / build (pull_request) Successful in 15s
Docs: caught up with v0.13.0 to v0.19.0
The documentation had kept up feature page by feature page and nowhere
else. Now also:

- the home page's App cards (notes of any size, pictures, sharing) and its
  note (the Shell, the VPN, the screenshot key);
- the guide: VPN in the Status Bar and in Settings, the three keys that work
  everywhere, screenshots of the Shell, a picture, sharing, the VPN page and
  the help panel;
- three how-tos: move files with your phone, set up the VPN, take a
  screenshot; where the files are and what things cost in memory;
- the FAQ: screenshots, and what listens on the network;
- the README's opening: what the firmware does today;
- the glossary: Tunnel, Sharing, Screenshot;
- every milestone's status line, with the version each thing shipped in.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
2026-10-08 01:49:47 +02:00

3.4 KiB

+++ title = "Settings" description = "The device's names, region, screen, sound, GNSS, Wi-Fi and VPN, and where firmware updates are found." weight = 11 [extra] tag = "Settings" +++

Move with the arrows. On a toggle, a choice or a slider, left and right change the value; Enter opens a text field or a list of choices, or a page marked >. Back leaves.

Setting What it is
Long name, Short name The names you gave in the first-start Setup (up to 39 bytes, and up to 4 characters)
Region The regulatory region; EU868
Timezone For the clock and the dates in file names
Brightness A slider
Dim after, Screen off after Screen timeouts. Dimming must come before the screen turns off
Sound & LED The beep and the flash on a Toast
GNSS Switches the receiver on and off (see GNSS)
Pause GNSS for LoRa Puts the receiver on standby while the radio listens (see LoRa Scanner)
Coordinates Decimal degrees, or degrees, minutes and seconds
Wi-Fi The page below
Check for updates Once a day, see Updates
Firmware The page described in Updates
VPN A WireGuard tunnel: its switch, "Start with Wi-Fi", and importing its configuration from the card. See VPN
Debug Console Off unless you switch it on. It lets a PC on the same network read the device's console and drive it, with a token shown on this page: see the developer docs. Leave it off if that means nothing to you
About The firmware version, the node number, battery, memory, uptime, clock and licence

Wi-Fi

Wi-Fi on its own page switches the radio on and off. The page also has:

  • Status: whether it is searching, joining, or connected, and to what.
  • Add a network: scans, lets you pick one, and asks for the password (leave it empty for an open network). Add a hidden network asks for the name first.
  • DNS and NTP: see below.
  • Your saved networks. The device joins one on its own whenever it is in range, the strongest first. Enter on a network opens its page.

An address by hand

A network normally gives the device its address by itself (DHCP, Automatic). On a network without DHCP, open its page and set IP address to Fixed: then it takes an address, a prefix (24 is 255.255.255.0) and an optional gateway. Switching to Fixed starts from what the network is giving the device at that moment, and the setting is checked and applied when you leave the page. IPv4 only. Forget this network is on the same page.

DNS and NTP

Two DNS servers (9.9.9.9 and 1.1.1.1 by default), used on Fixed networks, or on every network if Always use my DNS is on; and two NTP servers (pool.ntp.org and time.cloudflare.com), used after any that the network's DHCP offers. Enter on Status shows what is in use and where each value came from.

The keys, as the device lists them

What Fn + h shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.

{{ keys(scopes=["settings", "settings-choice", "wifi", "wifi-servers", "wifi-network", "wifi-status", "wifi-scan", "wifi-name", "vpn", "debug-console"]) }}