update linux native to use image as header

This commit is contained in:
rcarteraz 2025-02-14 21:56:43 -07:00
parent fe5361c8c6
commit cc2d274439

View file

@ -1,12 +1,27 @@
--- ---
id: linux-native-hardware id: linux-native-hardware
title: Meshtastic on Linux-Native Devices title: Meshtastic on Linux-Native Devices
hide_title: true
sidebar_label: Linux Native Devices sidebar_label: Linux Native Devices
sidebar_position: 11 sidebar_position: 11
description: Set up and configure Meshtastic on Linux-native devices using the meshtasticd binary. description: Set up and configure Meshtastic on Linux-native devices using the meshtasticd binary.
--- ---
import LinuxInstall from "@site/docs/blocks/_linux-install.mdx"; import LinuxInstall from "@site/docs/blocks/_linux-install.mdx";
import { Dark, Light } from "/src/components/ColorMode";
<Dark>
<img
src="/img/meshtasticd/Meshtasticd-Terminal-Long_Dark.svg"
alt="Meshtasticd Terminal Dark"
/>
</Dark>
<Light>
<img
src="/img/meshtasticd/Meshtasticd-Terminal-Long_Light.svg"
alt="Meshtasticd Terminal Light"
/>
</Light>
This page outlines the setup of Meshtastic on Linux-native devices, utilizing portduino to run the Meshtastic firmware under Linux. This page outlines the setup of Meshtastic on Linux-native devices, utilizing portduino to run the Meshtastic firmware under Linux.
@ -31,6 +46,7 @@ Before proceeding with the setup, ensure the device meets the following requirem
### Hardware Compatibility ### Hardware Compatibility
:::caution Warning :::caution Warning
- **UART** HATs and SX1302/SX1303 chip-based HATs are not supported. Only hats that use a SPI radio can work with Meshtastic. - **UART** HATs and SX1302/SX1303 chip-based HATs are not supported. Only hats that use a SPI radio can work with Meshtastic.
- The Waveshare SX1262 LoRaWAN Hat for Raspberry Pi is not recommended for deployment. It has known hardware limitations that may affect longer messages. If you must use it, please use the **CLIENT_MUTE** role to avoid rebroadcasting. - The Waveshare SX1262 LoRaWAN Hat for Raspberry Pi is not recommended for deployment. It has known hardware limitations that may affect longer messages. If you must use it, please use the **CLIENT_MUTE** role to avoid rebroadcasting.
- The Pine64 Pinedio is also not recommended for deployment, as it suffers from similar hardware limitations as the Waveshare SX1262 LoRaWAN Hat. - The Pine64 Pinedio is also not recommended for deployment, as it suffers from similar hardware limitations as the Waveshare SX1262 LoRaWAN Hat.
@ -183,40 +199,41 @@ To configure the device to start and stop meshtasticd as as service using system
<details> <details>
<summary>Create the systemd service (only for manual installs)</summary> <summary>Create the systemd service (only for manual installs)</summary>
The `meshtasticd` systemd service is automatically installed when using the official Meshtastic packages. The `meshtasticd` systemd service is automatically installed when using the official Meshtastic packages.
These instructions are only needed when installing manually. These instructions are only needed when installing manually.
Create the service unit file: Create the service unit file:
Create a new file in the /etc/systemd/system/ directory with a name like meshtasticd.service. Create a new file in the /etc/systemd/system/ directory with a name like meshtasticd.service.
```shell ```shell
sudo nano /etc/systemd/system/meshtasticd.service sudo nano /etc/systemd/system/meshtasticd.service
``` ```
Add the following content to the file: Add the following content to the file:
```plaintext ```plaintext
[Unit] [Unit]
Description=Meshtastic Daemon Description=Meshtastic Daemon
After=network.target After=network.target
[Service] [Service]
ExecStart=/usr/sbin/meshtasticd ExecStart=/usr/sbin/meshtasticd
Restart=always Restart=always
User=root User=root
Group=root Group=root
Type=simple Type=simple
[Install] [Install]
WantedBy=multi-user.target WantedBy=multi-user.target
``` ```
Reload systemd to recognize the new service: Reload systemd to recognize the new service:
```shell
sudo systemctl daemon-reload
```
```shell
sudo systemctl daemon-reload
```
</details> </details>
Enable the service to start on boot: Enable the service to start on boot: