Skip to content
e2ret edited this page Aug 25, 2026 · 16 revisions

🇷🇺 Русский | 🇬🇧 English


Русский

System — Система и обслуживание

System

Вкладка SYSTEM содержит инструменты обслуживания, обновления компонентов, контроля доступа и управления резервными копиями.

Вкладка разделена на две колонки: слева — действия и обслуживание (Quick Commands, Maintenance, System), справа — настройки (Chat Settings, Access Control, Telegram, Backup & Restore, Versions).

Quick Commands — Быстрые команды

Выполнение команд без SSH:

Команда Описание
PORTS Список подключённых USB устройств (lsusb, ls /dev/ttyUSB*)
RNSTATUS Статус всех интерфейсов Reticulum
RESTART RNSD Перезапустить Reticulum
RESTART LXMF Перезапустить LXMF Bridge
MEMORY Использование оперативной памяти
UPTIME Время работы системы
CLEAN LOGS Очистить системные логи
⬆ UPDATE NOEMA Обновить шлюз из GitHub и перезапустить сервисы

Update NOEMA

Кнопка ⬆ UPDATE NOEMA выполняет:

  1. git fetch + git reset --hard origin/main — приводит локальную копию точно к состоянию репозитория
  2. Обновляет Python-зависимости
  3. Перезапускает сервисы dashboard, noema_lxmf_bridge, rnsd

Если в заголовке дашборда появился оранжевый бейдж ⬆ UPDATE — доступна новая версия. Клик по бейджу запускает обновление.

⚠️ Любые несохранённые локальные изменения на устройстве будут перезаписаны версией из репозитория.

Ручное обновление через SSH

Если версия дашборда старая и кнопка ⬆ Update NOEMA ещё не появилась (или дашборд не открывается):

cd /root/NOEMA-RNSGate-Lite && git fetch origin && git reset --hard origin/main
systemctl restart dashboard noema_lxmf_bridge rnsd

Это то же самое, что делает кнопка Update NOEMA в дашборде — приводит локальную копию к актуальному состоянию репозитория и перезапускает основные сервисы.

⚠️ Не редактируйте файлы проекта вручную через SSH (install.sh, app.py, index.html и т.д.) — такие правки git не отслеживает как коммит, и при следующем автообновлении получите ошибку Your local changes... would be overwritten by merge, а обновление прервётся. Если что-то поправили вручную для теста — либо откатите (git checkout -- имя_файла), либо примите что при следующем обновлении это будет перезаписано командой выше.

Maintenance — Обслуживание

Настройка Описание
Перезапускать rnsd каждую ночь в 04:00 Автоматический ночной restart Reticulum через cron — освобождает накопленную память (таблица маршрутов растёт со временем на активных сетях)
TCP watchdog Каждые 5 минут проверяет статус TCP-интерфейсов (rnstatus) и автоматически перезапускает rnsd, если обнаружен разорванный TCP-интерфейс — актуально при нестабильном интернете/перебоях с электричеством

Оба переключателя управляют системным cron напрямую. Состояние подтягивается из реального crontab при каждом открытии вкладки.

TCP watchdog защищён cooldown 10 минут между перезапусками — не устроит restart-storm во время длительного отключения, просто ждёт следующей проверки. Лог работы: /var/log/noema_tcp_watchdog.log.

ℹ️ Ночной restart и TCP watchdog решают разные задачи: первый освобождает память от разросшейся таблицы маршрутов по расписанию, второй — реагирует на реальный обрыв соединения по факту. Рекомендуется включить оба.

System — Управление устройством

Действие Описание
Restart Dashboard Перезапустить только веб-приложение (с задержкой в фоне — кнопка отвечает до перезапуска процесса)
Reboot Device Перезагрузить устройство целиком
Reset All Identity Сбросить все криптографические ключи

Reset All Identity

Удаляет все идентификаторы шлюза. Используйте перед продажей или передачей устройства.

Что удаляется:

  • LXMF ключи (bridge и chat)
  • Reticulum identity
  • I2P ключи (router + tunnel)
  • Nomadnet identity
  • История чата и контакты

Что сохраняется:

  • Конфиги MQTT и Reticulum
  • Страницы Nomadnet (.mu файлы)
  • Скрипты

⚠️ Необратимо. После сброса устройство получит новые адреса. Сделайте Backup заранее.

ℹ️ Начиная с v1.4.5, Reset All Identity корректно сбрасывает все адреса, включая LXMF Bridge (ранее был баг: identity моста хранится в lxmf-tools/lxmfy_data/lxmfy_config, а не по старому пути, из-за чего адрес Bridge не менялся). Обновите дашборд до актуальной версии.

Chat Settings — Настройки чата

Настройка Описание
Max messages per contact Максимум сообщений в истории на контакт
Max files MB Максимальный суммарный размер вложений
Notification sound Звук уведомления о новом сообщении (Default, Double beep, High, Low, Bell, Off)
Volume Громкость уведомления 0–100%

Кнопки:

  • Save limits — сохранить лимиты
  • Clean files now — удалить файлы сверх лимита
  • Clear all history — очистить всю историю чатов и файлы

Access Control — Контроль доступа

Защита от нежелательных сообщений на адреса шлюза. Два независимых whitelist'а — для LXMF Bridge и для встроенного NOEMA Chat. Дополнительно оба тракта защищены от дублей сообщений.

Bridge Access Control

Ограничивает кто может отправлять сообщения на адрес LXMF Bridge (тот, что пересылает в MQTT → Home Assistant).

Поле Описание
Whitelist toggle Если включён — принимаются сообщения только с адресов из списка, остальные молча отбрасываются
Разрешённые LXMF-адреса Список hex-адресов (32 символа), добавление/удаление кнопками
Rate limit Максимум сообщений в минуту от одного отправителя (по умолчанию 5)
Cooldown Блокировка отправителя при превышении лимита, в секундах (по умолчанию 60)

Изменения сохраняются в /etc/noema/bridge.cfg (секция [access]) и автоматически перезапускают noema_lxmf_bridge для применения.

⚠️ Не добавляйте в whitelist адрес самого шлюза — он показан в заголовке дашборда и в логах bridge при старте ([NOEMA] Address: ...). Whitelist должен содержать адреса отправителей (ваш телефон, доверенные контакты), а не адрес получателя.

Chat Access Control

Тот же принцип, но для входящих сообщений в NOEMA Chat дашборда (не влияет на Bridge/MQTT).

Поле Описание
Whitelist toggle Если включён — в чат сохраняются сообщения только с адресов из списка
Разрешённые LXMF-адреса Отдельный список от Bridge whitelist

Сохраняется в /etc/noema/bridge.cfg (секция [chat_access]), применяется сразу, без перезапуска dashboard.

Дедупликация сообщений

Работает автоматически, без отдельных настроек в дашборде. При наличии нескольких TCP-интерфейсов до одного и того же контакта (rmap.world, узлы-релеи и т.д.) LXMF-сообщение может доставиться несколько раз одновременно по разным маршрутам. И Bridge, и Chat запоминают уникальный идентификатор каждого сообщения на 1 час и молча отбрасывают повторы — предотвращает двойное срабатывание автоматизаций Home Assistant и дублирование записей в истории чата.

Как узнать свой LXMF-адрес для добавления в whitelist

  • CrossTalk: Settings → LXMF Address (внизу списка чатов)
  • Sideband: значок identity в шапке приложения
  • NomadNet: команда !i в консоли, или в настройках identity

Local AI — Локальный AI в LXMF Bridge

LXMF Bridge может отвечать на вопросы через локальную LLM (llama.cpp или Ollama-совместимый сервер) прямо в чате — полностью офлайн, без обращения к интернету.

Настройка

Добавьте секцию [llm] в /etc/noema/bridge.cfg:

[llm]
enabled = 1
url = http://ВАШ_LLM_СЕРВЕР:8090/completion
max_tokens = 256
timeout = 60
system_prompt = You are a helpful assistant reachable over a Reticulum mesh. Keep answers short.
Параметр Описание
enabled 1 включает команду /ask, по умолчанию 0 (выключено)
url Адрес /completion-эндпоинта вашего llama.cpp сервера (llama-server)
max_tokens Максимальная длина ответа модели
timeout Таймаут ожидания ответа, в секундах
system_prompt Системный промпт, задаёт поведение модели

После правки конфига перезапустите bridge:

systemctl restart noema_lxmf_bridge

Использование

Отправьте /ask <вопрос> на адрес LXMF Bridge из любого LXMF-клиента (Sideband, CrossTalk). Бот сразу ответит "🤖 Thinking…", а через несколько секунд пришлёт ответ модели отдельным сообщением с заголовком "AI".

Запрос к модели выполняется в отдельном потоке — не блокирует обработку остальных LXMF-сообщений во время генерации ответа.

ℹ️ Требует уже запущенный и доступный по сети LLM-сервер (llama.cpp/llama-server с OpenAI-совместимым /completion API). Шлюз сам модель не запускает и не хранит.

Telegram Notifications — Уведомления в Telegram

Шлюз может отправлять уведомления в Telegram при получении входящих сообщений.

Настройка

  1. Создайте бота через @BotFather → получите Bot Token
  2. Узнайте свой Chat ID через @userinfobot
  3. Введите токен и chat_id в поля → нажмите Save
  4. Нажмите Test — должно прийти тестовое сообщение

Источники уведомлений

Чекбокс Описание
LXMF Bridge messages Уведомления при сообщениях на адрес LXMF Bridge (бота)
Chat messages Уведомления при сообщениях в личный чат шлюза (NOEMA Chat)

Backup & Restore — Резервное копирование

Что входит в Backup

Категория Файлы
configs reticulum.cfg, noema_bridge.cfg (включая access/chat_access/llm настройки), nomadnet.cfg, i2p tunnels
identity LXMF Bridge identity (lxmfy_data/lxmfy_config), reticulum identity, i2p router keys, tunnel keys, rns destinations, chat lxmf identity
pages Все .mu файлы Nomadnet
scripts Все .py и .sh скрипты
data chat_history, chat_contacts, chat_files, monitored_nodes

Создание backup

Нажмите DOWNLOAD BACKUP — скачается архив noema_backup_YYYYMMDD_HHMMSS.zip.

Восстановление из backup

  1. Нажмите RESTORE FROM BACKUP
  2. Выберите архив .zip
  3. Нажмите UPLOAD
  4. Перезагрузите устройство

После восстановления все адреса шлюза (включая LXMF Bridge), история чата, whitelist'ы, страницы и скрипты восстанавливаются в исходное состояние.

✅ Backup сохраняет все криптографические ключи, включая identity LXMF Bridge — после восстановления адреса шлюза остаются прежними.

ℹ️ Начиная с v1.4.5, Backup корректно сохраняет, а Restore корректно восстанавливает identity LXMF Bridge (ранее был баг: бэкап ссылался на несуществующий старый путь, из-за чего адрес Bridge не восстанавливался). Бэкапы, сделанные до этого фикса, не содержат identity моста — сделайте новый бэкап после обновления.

Versions — Версии компонентов

Таблица установленных и актуальных версий:

Компонент Описание
Python Версия интерпретатора
RNS Reticulum Network Stack
LXMF Протокол сообщений
lxmfy Фреймворк LXMF-ботов
nomadnet Узел Nomadnet
paho-mqtt MQTT клиент
Flask Веб-фреймворк дашборда

При наличии обновления — кнопка UPDATE. При отсутствии компонента — INSTALL. Обновление выполняется без SSH.

Устранение неполадок

Проблема Решение
LoRa не определяется Quick Commands → PORTS, проверьте USB кабель
MQTT BROKER: ERR Проверьте IP брокера в Configs, логин и пароль
Сервис упал Logs → выберите сервис, или journalctl -u имя_сервиса -n 50
Нет маршрута к контакту Quick Commands → RESTART RNSD, подождите 30–60 сек
Dashboard не открывается systemctl restart dashboard
I2P нестабилен Норма первые 5–10 минут после запуска
Забыл IP шлюза Список клиентов роутера, или ping noema.local
Telegram не отправляет Проверьте токен и chat_id, нажмите Test в настройках
Нет уведомления об обновлении Шлюз проверяет GitHub каждые 5 минут
Whitelist включён, но сообщения не проходят Проверьте что в списке ваш адрес отправителя, а не адрес шлюза; сверьте hex посимвольно
Растёт использование памяти со временем Включите Maintenance → ночной перезапуск rnsd, или journalctl -u rnsd для проверки таблицы маршрутов
TCP-интерфейс завис после отключения интернета Включите Maintenance → TCP watchdog; проверить вручную: rnstatus, лог: /var/log/noema_tcp_watchdog.log
Настройки Access Control не отображаются в интерфейсе Обновите страницу (Ctrl+Shift+R), это обычно кэш браузера от старой версии дашборда
После Reset Identity адрес LXMF Bridge не изменился Обновите дашборд до v1.4.5+ — известный баг был исправлен
После Restore адрес LXMF Bridge не совпадает с бэкапом Убедитесь что бэкап сделан на v1.4.5+; старые бэкапы не содержат identity моста
/ask не отвечает / ошибка LLM Проверьте что enabled=1 в [llm], LLM-сервер доступен по указанному url: curl URL_СЕРВЕРА/health
Обновление прервалось с ошибкой local changes would be overwritten by merge Файл на устройстве был отредактирован вручную через SSH и не совпадает с репозиторием. Решение: cd /root/NOEMA-RNSGate-Lite && git fetch origin && git reset --hard origin/main, затем systemctl restart dashboard noema_lxmf_bridge rnsd. Ручные правки будут потеряны — если они важны, сохраните их отдельно перед сбросом

English

System — System and Maintenance

System

The SYSTEM tab contains maintenance tools, component updates, access control, and backup management.

The tab is split into two columns: left — actions and maintenance (Quick Commands, Maintenance, System), right — settings (Chat Settings, Access Control, Telegram, Backup & Restore, Versions).

Quick Commands

Run commands without SSH:

Command Description
PORTS List connected USB devices (lsusb, ls /dev/ttyUSB*)
RNSTATUS Status of all Reticulum interfaces
RESTART RNSD Restart Reticulum
RESTART LXMF Restart LXMF Bridge
MEMORY RAM usage
UPTIME System uptime
CLEAN LOGS Clear system logs
⬆ UPDATE NOEMA Update the gateway from GitHub and restart services

Update NOEMA

The ⬆ UPDATE NOEMA button does:

  1. git fetch + git reset --hard origin/main — brings the local copy exactly in line with the repository
  2. Updates Python dependencies
  3. Restarts the dashboard, noema_lxmf_bridge, and rnsd services

If an orange ⬆ UPDATE badge appears in the dashboard header, a new version is available. Click it to trigger the update.

⚠️ Any unsaved local changes on the device will be overwritten by the repository version.

Manual update via SSH

If the version is old and the ⬆ Update NOEMA button isn't there yet (or the dashboard won't open):

cd /root/NOEMA-RNSGate-Lite && git fetch origin && git reset --hard origin/main
systemctl restart dashboard noema_lxmf_bridge rnsd

This is exactly what the Update NOEMA button does in the dashboard — brings the local copy in line with the repository and restarts the core services.

⚠️ Don't edit project files manually over SSH (install.sh, app.py, index.html, etc.) — git doesn't track such edits as a commit, and the next auto-update will fail with Your local changes... would be overwritten by merge, aborting the update. If you edited something manually for testing, either revert it (git checkout -- filename) or accept that it'll be overwritten by the command above on the next update.

Maintenance

Setting Description
Restart rnsd every night at 04:00 Automatic nightly Reticulum restart via cron — frees up accumulated memory (the routing table grows over time on active networks)
TCP watchdog Checks TCP interface status (rnstatus) every 5 minutes and automatically restarts rnsd if a dropped TCP interface is detected — useful on unstable internet or during power outages

Both toggles control the system cron directly. State is pulled from the real crontab every time you open the tab.

TCP watchdog has a 10-minute cooldown between restarts — it won't restart-storm during a long outage, it just waits for the next check. Log: /var/log/noema_tcp_watchdog.log.

ℹ️ The nightly restart and the TCP watchdog solve different problems: the first frees memory from a bloated routing table on a schedule, the second reacts to an actual dropped connection. Recommended to enable both.

System — Device Management

Action Description
Restart Dashboard Restarts only the web app (with a background delay — the button responds before the process restarts)
Reboot Device Reboots the whole device
Reset All Identity Resets all cryptographic keys

Reset All Identity

Deletes all of the gateway's identifiers. Use this before selling or handing off the device.

What gets deleted:

  • LXMF keys (bridge and chat)
  • Reticulum identity
  • I2P keys (router + tunnel)
  • Nomadnet identity
  • Chat history and contacts

What's kept:

  • MQTT and Reticulum configs
  • Nomadnet pages (.mu files)
  • Scripts

⚠️ Irreversible. After a reset, the device gets new addresses. Take a Backup beforehand.

ℹ️ Since v1.4.5, Reset All Identity correctly resets all addresses, including LXMF Bridge (previously there was a bug: the bridge identity is stored in lxmf-tools/lxmfy_data/lxmfy_config, not the old path, so the Bridge address wasn't changing). Update your dashboard to the latest version.

Chat Settings

Setting Description
Max messages per contact Maximum messages kept in history per contact
Max files MB Maximum total size of attachments
Notification sound New message sound (Default, Double beep, High, Low, Bell, Off)
Volume Notification volume 0–100%

Buttons:

  • Save limits — save the limits
  • Clean files now — delete files over the limit
  • Clear all history — clear all chat history and files

Access Control

Protection against unwanted messages to the gateway's addresses. Two independent whitelists — for the LXMF Bridge and for the built-in NOEMA Chat. Both paths are additionally protected against duplicate messages.

Bridge Access Control

Restricts who can send messages to the LXMF Bridge address (the one that forwards to MQTT → Home Assistant).

Field Description
Whitelist toggle When on — only messages from listed addresses are accepted, everything else is silently dropped
Allowed LXMF addresses A list of hex addresses (32 characters), add/remove via buttons
Rate limit Max messages per minute from a single sender (default 5)
Cooldown Sender blocked when the limit is exceeded, in seconds (default 60)

Changes are saved to /etc/noema/bridge.cfg (section [access]) and automatically restart noema_lxmf_bridge to apply.

⚠️ Don't add the gateway's own address to the whitelist — it's shown in the dashboard header and in the bridge logs at startup ([NOEMA] Address: ...). The whitelist should contain sender addresses (your phone, trusted contacts), not the recipient's.

Chat Access Control

Same principle, but for incoming messages to the dashboard's NOEMA Chat (doesn't affect Bridge/MQTT).

Field Description
Whitelist toggle When on — only messages from listed addresses get saved to chat
Allowed LXMF addresses Separate list from the Bridge whitelist

Saved to /etc/noema/bridge.cfg (section [chat_access]), applies immediately, no dashboard restart needed.

Message deduplication

Works automatically, no separate settings in the dashboard. With multiple TCP interfaces to the same contact (rmap.world, relay nodes, etc.), an LXMF message can arrive more than once over different routes at the same time. Both Bridge and Chat remember each message's unique ID for 1 hour and silently drop repeats — prevents double-triggering Home Assistant automations and duplicate entries in chat history.

How to find your LXMF address to add to the whitelist

  • CrossTalk: Settings → LXMF Address (bottom of the chat list)
  • Sideband: identity icon in the app header
  • NomadNet: !i command in the console, or in identity settings

Local AI — Local AI in the LXMF Bridge

The LXMF Bridge can answer questions using a local LLM (llama.cpp or an Ollama-compatible server) right in the chat — fully offline, no internet required.

Setup

Add a [llm] section to /etc/noema/bridge.cfg:

[llm]
enabled = 1
url = http://YOUR_LLM_SERVER:8090/completion
max_tokens = 256
timeout = 60
system_prompt = You are a helpful assistant reachable over a Reticulum mesh. Keep answers short.
Parameter Description
enabled 1 enables the /ask command, defaults to 0 (off)
url Your llama.cpp server's (llama-server) /completion endpoint address
max_tokens Maximum length of the model's reply
timeout Reply wait timeout, in seconds
system_prompt System prompt that shapes the model's behavior

After editing the config, restart the bridge:

systemctl restart noema_lxmf_bridge

Usage

Send /ask <question> to the LXMF Bridge address from any LXMF client (Sideband, CrossTalk). The bot immediately replies "🤖 Thinking…", then sends the model's answer as a separate message titled "AI" a few seconds later.

The query to the model runs in a separate thread — it doesn't block processing of other LXMF messages while the answer is being generated.

ℹ️ Requires an LLM server (llama.cpp/llama-server with an OpenAI-compatible /completion API) already running and reachable on the network. The gateway itself doesn't run or store the model.

Telegram Notifications

The gateway can send Telegram notifications when it receives incoming messages.

Setup

  1. Create a bot via @BotFather → get a Bot Token
  2. Find your Chat ID via @userinfobot
  3. Enter the token and chat_id in the fields → click Save
  4. Click Test — you should receive a test message

Notification sources

Checkbox Description
LXMF Bridge messages Notifications for messages to the LXMF Bridge (bot) address
Chat messages Notifications for messages in the gateway's personal chat (NOEMA Chat)

Backup & Restore

What's included in a Backup

Category Files
configs reticulum.cfg, noema_bridge.cfg (including access/chat_access/llm settings), nomadnet.cfg, i2p tunnels
identity LXMF Bridge identity (lxmfy_data/lxmfy_config), reticulum identity, i2p router keys, tunnel keys, rns destinations, chat lxmf identity
pages All Nomadnet .mu files
scripts All .py and .sh scripts
data chat_history, chat_contacts, chat_files, monitored_nodes

Creating a backup

Click DOWNLOAD BACKUP — downloads a noema_backup_YYYYMMDD_HHMMSS.zip archive.

Restoring from a backup

  1. Click RESTORE FROM BACKUP
  2. Select the .zip archive
  3. Click UPLOAD
  4. Reboot the device

After restoring, all gateway addresses (including LXMF Bridge), chat history, whitelists, pages, and scripts return to their original state.

✅ Backup preserves all cryptographic keys, including the LXMF Bridge identity — gateway addresses stay the same after restoring.

ℹ️ Since v1.4.5, Backup correctly saves and Restore correctly restores the LXMF Bridge identity (previously there was a bug: the backup pointed to a nonexistent old path, so the Bridge address wasn't being restored). Backups made before this fix don't contain the bridge identity — take a new backup after updating.

Versions

Table of installed and latest component versions:

Component Description
Python Interpreter version
RNS Reticulum Network Stack
LXMF Messaging protocol
lxmfy LXMF bot framework
nomadnet Nomadnet node
paho-mqtt MQTT client
Flask Dashboard web framework

If an update is available — an UPDATE button appears. If a component is missing — INSTALL. Updates run without SSH.

Troubleshooting

Problem Solution
LoRa not detected Quick Commands → PORTS, check the USB cable
MQTT BROKER: ERR Check the broker IP in Configs, login, password
Service crashed Logs → pick the service, or journalctl -u service_name -n 50
No route to contact Quick Commands → RESTART RNSD, wait 30–60 sec
Dashboard won't open systemctl restart dashboard
I2P unstable Normal for the first 5–10 minutes after startup
Forgot the gateway's IP Check your router's client list, or ping noema.local
Telegram not sending Check the token and chat_id, click Test in settings
No update notification The gateway checks GitHub every 5 minutes
Whitelist enabled, messages don't get through Check that the list has your sender address, not the gateway's; verify the hex character by character
Memory usage grows over time Enable Maintenance → nightly rnsd restart, or check journalctl -u rnsd for the routing table
TCP interface stuck after an internet outage Enable Maintenance → TCP watchdog; check manually with rnstatus, log: /var/log/noema_tcp_watchdog.log
Access Control settings not showing in the UI Refresh the page (Ctrl+Shift+R), usually a browser cache from an older dashboard version
LXMF Bridge address didn't change after Reset Identity Update the dashboard to v1.4.5+ — this known bug was fixed
LXMF Bridge address doesn't match the backup after Restore Make sure the backup was made on v1.4.5+; older backups don't contain the bridge identity
/ask doesn't respond / LLM error Check that enabled=1 under [llm], and the LLM server is reachable at the configured url: curl SERVER_URL/health
Update fails with local changes would be overwritten by merge A file on the device was edited manually over SSH and no longer matches the repository. Fix: cd /root/NOEMA-RNSGate-Lite && git fetch origin && git reset --hard origin/main, then systemctl restart dashboard noema_lxmf_bridge rnsd. Manual edits will be lost — save them elsewhere first if they matter

Clone this wiki locally