Skip to main content

Enable WiFi Pairing Mode

Add or change your local network settings.

Written by Ryan Kulp

TRMNL supports multiple WiFi credential pairs, all of which is stored locally on your device and never sent to the cloud or your BYOS server clients.

If you change network settings or moved your TRMNL between locations, you might need to update the WiFi configuration.

Select your device for instructions to reset WiFi.

Quick Links:

TRMNL OG (7.5" device)

Resetting WiFi on the OG is a simple process.

Manually Enter Pairing Mode

With your TRMNL device already turned on, hold the boot button on the back of your TRMNL for 6-8 seconds, then let go and it should enter WiFi pairing mode. You can also try holding the button for 15-20 seconds if this shorter value doesn't work.

Set a Macro for Pairing Mode

If you anticipate frequent WiFi or location changes for your TRMNL, consider setting a special function so make your device enters WiFi pairing whenever you medium-press (1-2s hold) on the boot button.

Default approach to Pairing Mode

If your device has become unresponsive, turn it off for 10 seconds to reset the buffer. Then turn it back on. If the network SSID is not found, it should re-enter pairing mode.


TRMNL X (10.3" device)

Firmware 1.8.18 moves Wi-Fi reset into an on-device menu, and devices move to it over the coming weeks. To see which firmware you have, look for Current firmware under Device Info in your device settings.

Firmware 1.8.18 and later

Tap the middle of the touchbar to open the menu. Tap left or right to move the arrow, and tap the middle to choose.

Choose Settings..., then Reset Wi-Fi.... The X asks "Forget the saved Wi-Fi network and open the setup portal?" with the arrow on Back. Tap left to move it to Confirm Reset Wi-Fi, then tap the middle.

If the touchbar tutorial opens instead of the menu, finish it first: tap left, then center, then right, then tap anywhere. Then tap the middle again.

On 1.8.18, an error screen may still tell you to hold the left and right corners of the touch bar. That no longer works, so use the menu above instead.

Manually Enter Pairing Mode (earlier firmware)

See this video or follow the steps below it.

Steps from the video

Hold both the left and the right side of the touchbar until the screen blinks:

Tap the middle to cancel, or hold the middle to enter pairing mode:

Have a TRMNL X? Our troubleshooter walks you through the most common problems in a couple of minutes.

Related

Did this answer your question?