Repository navigation
System
Вкладка SYSTEM содержит инструменты обслуживания, обновления компонентов, контроля доступа и управления резервными копиями.
Вкладка разделена на две колонки: слева — действия и обслуживание (Quick Commands, Maintenance, System), справа — настройки (Chat Settings, Access Control, Telegram, Backup & Restore, Versions).
Выполнение команд без 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 выполняет:
-
git fetch+git reset --hard origin/main— приводит локальную копию точно к состоянию репозитория - Обновляет Python-зависимости
- Перезапускает сервисы dashboard, noema_lxmf_bridge, rnsd
Если в заголовке дашборда появился оранжевый бейдж ⬆ UPDATE — доступна новая версия. Клик по бейджу запускает обновление.
⚠️ Любые несохранённые локальные изменения на устройстве будут перезаписаны версией из репозитория.
Если версия дашборда старая и кнопка ⬆ 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 -- имя_файла), либо примите что при следующем обновлении это будет перезаписано командой выше.
| Настройка | Описание |
|---|---|
| Перезапускать 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 решают разные задачи: первый освобождает память от разросшейся таблицы маршрутов по расписанию, второй — реагирует на реальный обрыв соединения по факту. Рекомендуется включить оба.
| Действие | Описание |
|---|---|
| Restart Dashboard | Перезапустить только веб-приложение (с задержкой в фоне — кнопка отвечает до перезапуска процесса) |
| Reboot Device | Перезагрузить устройство целиком |
| 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 не менялся). Обновите дашборд до актуальной версии.
| Настройка | Описание |
|---|---|
| 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 — очистить всю историю чатов и файлы
Защита от нежелательных сообщений на адреса шлюза. Два независимых whitelist'а — для LXMF Bridge и для встроенного NOEMA Chat. Дополнительно оба тракта защищены от дублей сообщений.
Ограничивает кто может отправлять сообщения на адрес 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 должен содержать адреса отправителей (ваш телефон, доверенные контакты), а не адрес получателя.
Тот же принцип, но для входящих сообщений в 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 и дублирование записей в истории чата.
- CrossTalk: Settings → LXMF Address (внизу списка чатов)
- Sideband: значок identity в шапке приложения
-
NomadNet: команда
!iв консоли, или в настройках identity
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-совместимым
/completionAPI). Шлюз сам модель не запускает и не хранит.
Шлюз может отправлять уведомления в Telegram при получении входящих сообщений.
- Создайте бота через @BotFather → получите Bot Token
- Узнайте свой Chat ID через @userinfobot
- Введите токен и chat_id в поля → нажмите Save
- Нажмите Test — должно прийти тестовое сообщение
| Чекбокс | Описание |
|---|---|
| LXMF Bridge messages | Уведомления при сообщениях на адрес LXMF Bridge (бота) |
| Chat messages | Уведомления при сообщениях в личный чат шлюза (NOEMA Chat) |
| Категория | Файлы |
|---|---|
| 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 |
Нажмите DOWNLOAD BACKUP — скачается архив noema_backup_YYYYMMDD_HHMMSS.zip.
- Нажмите RESTORE FROM BACKUP
- Выберите архив
.zip - Нажмите UPLOAD
- Перезагрузите устройство
После восстановления все адреса шлюза (включая LXMF Bridge), история чата, whitelist'ы, страницы и скрипты восстанавливаются в исходное состояние.
✅ Backup сохраняет все криптографические ключи, включая identity LXMF Bridge — после восстановления адреса шлюза остаются прежними.
ℹ️ Начиная с v1.4.5, Backup корректно сохраняет, а Restore корректно восстанавливает identity LXMF Bridge (ранее был баг: бэкап ссылался на несуществующий старый путь, из-за чего адрес Bridge не восстанавливался). Бэкапы, сделанные до этого фикса, не содержат identity моста — сделайте новый бэкап после обновления.
Таблица установленных и актуальных версий:
| Компонент | Описание |
|---|---|
| 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. Ручные правки будут потеряны — если они важны, сохраните их отдельно перед сбросом |
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).
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 |
The ⬆ UPDATE NOEMA button does:
-
git fetch+git reset --hard origin/main— brings the local copy exactly in line with the repository - Updates Python dependencies
- 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.
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 rnsdThis 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 withYour 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.
| 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.
| 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 |
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.
| 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
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.
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.
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.
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.
- CrossTalk: Settings → LXMF Address (bottom of the chat list)
- Sideband: identity icon in the app header
-
NomadNet:
!icommand in the console, or in identity settings
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.
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_bridgeSend /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
/completionAPI) already running and reachable on the network. The gateway itself doesn't run or store the model.
The gateway can send Telegram notifications when it receives incoming messages.
- Create a bot via @BotFather → get a Bot Token
- Find your Chat ID via @userinfobot
- Enter the token and chat_id in the fields → click Save
- Click Test — you should receive a test message
| 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) |
| 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 |
Click DOWNLOAD BACKUP — downloads a noema_backup_YYYYMMDD_HHMMSS.zip archive.
- Click RESTORE FROM BACKUP
- Select the
.ziparchive - Click UPLOAD
- 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.
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.
| 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 |