Skip to main content

Miscellaneous Settings



SettingAcceptable ValuesDefault
debug_log_enabledtrue, falsefalse
factory_resettrue, falsefalse
frequency_offsetreal numbers0
ignore_incomingstring โ€“ list of node nums to ignore0
serial_disabledtrue, falsefalse


By default we turn off logging as soon as an API client connects (to keep shared serial link quiet and save bandwidth). Set this to true to leave the debug log outputting even when API is active.


This setting is never saved to disk, but if set, all device settings will be returned to factory defaults. (Region, serial number etc... will be preserved)


This parameter is for advanced users with advanced test equipment, we do not recommend most users use it. A frequency offset that is added to to the calculated band center frequency. Used to correct for crystal calibration errors.


If true, radio should not try to be smart about what packets to queue to the phone bool keep_all_packets = 101; If true, we will try to capture all the packets sent on the mesh, not just the ones destined to our node. bool promiscuous_mode = 102; For testing it is useful sometimes to force a node to never listen to particular other nodes (simulating radio out of range). All nodenums listed in ignore_incoming will have packets they send dropped on receive (by router.cpp)


If set, this will disable the SerialConsole by not initilizing the StreamAPI.


Debug Log - Disable


debug_log_enabled set to false is the default behavior.

Example - Disable debug log
meshtastic --set debug_log_enabled false

Debug Log - Enable

Example - Enable debug log
meshtastic --set debug_log_enabled true

Factory reset

Example - Factory reset
meshtastic --set factory_reset true

Frequency Offset


Ignore Incoming


Serial - Disable

Example - Disable serial
meshtastic --set disable_serial true

Serial - Enable


disable_serial set to false is the default behavior.

Example - Enable serial
meshtastic --set disable_serial false