Switch Language

_linux-install

Debian</>} default> Debian packages are provided via OpenSUSE Build Service.

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ✅     |
| 🌐 [Web][WebClient]      | ✅     |

Supported: `trixie` (13), `bookworm` (12)

**Install - Debian 13 (`trixie`):**

```shell
[[ "$(. /etc/os-release && echo $NAME)" == Raspbian* ]] && echo "ERROR: Raspberry Pi OS (32-bit) detected, please use the Raspbian repos."
echo 'deb http://download.opensuse.org/repositories/network:/Meshtastic:/beta/Debian_13/ /' | sudo tee /etc/apt/sources.list.d/network:Meshtastic:beta.list
curl -fsSL https://download.opensuse.org/repositories/network:Meshtastic:beta/Debian_13/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/network_Meshtastic_beta.gpg > /dev/null
sudo apt update
sudo apt install meshtasticd
```

**Install - Debian 12 (`bookworm`):**

```shell
[[ "$(. /etc/os-release && echo $NAME)" == Raspbian* ]] && echo "ERROR: Raspberry Pi OS (32-bit) detected, please use the Raspbian repos."
echo 'deb http://download.opensuse.org/repositories/network:/Meshtastic:/beta/Debian_12/ /' | sudo tee /etc/apt/sources.list.d/network:Meshtastic:beta.list
curl -fsSL https://download.opensuse.org/repositories/network:Meshtastic:beta/Debian_12/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/network_Meshtastic_beta.gpg > /dev/null
sudo apt update
sudo apt install meshtasticd
```


  Experimental builds

  These builds are provided without support, please **do not file issues** relating to Experimental builds.

  Experimental Support: `forky` (testing), `sid` (unstable)

  **Install - Debian 14 (`forky`):**

  ```shell
  echo 'deb http://download.opensuse.org/repositories/network:/Meshtastic:/beta/Debian_Testing/ /' | sudo tee /etc/apt/sources.list.d/network:Meshtastic:beta.list
  curl -fsSL https://download.opensuse.org/repositories/network:Meshtastic:beta/Debian_Testing/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/network_Meshtastic_beta.gpg > /dev/null
  sudo apt update
  sudo apt install meshtasticd
  ```

  **Install - Debian unstable (`sid`):**

  ```shell
  echo 'deb http://download.opensuse.org/repositories/network:/Meshtastic:/beta/Debian_Unstable/ /' | sudo tee /etc/apt/sources.list.d/network:Meshtastic:beta.list
  curl -fsSL https://download.opensuse.org/repositories/network:Meshtastic:beta/Debian_Unstable/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/network_Meshtastic_beta.gpg > /dev/null
  sudo apt update
  sudo apt install meshtasticd
  ```

Raspbian (32-bit)</>}> Raspbian (Raspberry Pi OS) packages are provided via OpenSUSE Build Service.

:::warning
These builds are only suitable for 32-bit *armhf* Raspberry Pi OS installations.

For **64-bit** Raspberry Pi OS installations, please use the [<Icon icon="mdi:debian"/> Debian](../../docs/software/linux/installation/?os=debian.html) packages.
:::

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ✅     |
| 🌐 [Web][WebClient]      | ✅     |

Supported: `trixie` (13), `bookworm` (12)

**Install - Raspbian 13 (`trixie`):**

```shell
[[ "$(. /etc/os-release && echo $NAME)" != Raspbian* ]] && echo "ERROR: Raspberry Pi OS (32-bit) not detected, please use the Debian repos."
echo 'deb http://download.opensuse.org/repositories/network:/Meshtastic:/beta/Raspbian_13/ /' | sudo tee /etc/apt/sources.list.d/network:Meshtastic:beta.list
curl -fsSL https://download.opensuse.org/repositories/network:Meshtastic:beta/Raspbian_13/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/network_Meshtastic_beta.gpg > /dev/null
sudo apt update
sudo apt install meshtasticd
```

**Install - Raspbian 12 (`bookworm`):**

```shell
[[ "$(. /etc/os-release && echo $NAME)" != Raspbian* ]] && echo "ERROR: Raspberry Pi OS (32-bit) not detected, please use the Debian repos."
echo 'deb http://download.opensuse.org/repositories/network:/Meshtastic:/beta/Raspbian_12/ /' | sudo tee /etc/apt/sources.list.d/network:Meshtastic:beta.list
curl -fsSL https://download.opensuse.org/repositories/network:Meshtastic:beta/Raspbian_12/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/network_Meshtastic_beta.gpg > /dev/null
sudo apt update
sudo apt install meshtasticd
```

Ubuntu</>}> Ubuntu packages are provided via Canonical Launchpad.

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ✅     |
| 🌐 [Web][WebClient]      | ✅     |

Supported: `plucky` (25.04), `noble` (24.04 LTS), `jammy` (22.04 LTS)

**Install:**

```shell
# Install requirements for add-apt-repository
sudo apt install software-properties-common
# Add Meshtastic repo
sudo add-apt-repository ppa:meshtastic/beta
# Install meshtasticd
sudo apt install meshtasticd
```


  Experimental builds

  These builds are provided without support, please **do not file issues** relating to Experimental builds.

  Experimental Support: `questing` (25.10)

  **Install:**

  > Install via the instructions above.

Fedora</>}> Fedora packages are provided via Fedora COPR.

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ✅     |
| 🌐 [Web][WebClient]      | ✅     |

Supported: Fedora `42`, Fedora `41`

**Install:**

```shell
# Add Meshtastic COPR repo
sudo dnf copr enable @meshtastic/beta
# Install meshtasticd
sudo dnf install meshtasticd
```


  Experimental builds

  These builds are provided without support, please **do not file issues** relating to Experimental builds.

  Experimental Support: Fedora `43`

  **Install:**

  > Install via the instructions above.

RedHat (EPEL)</>}> RedHat (EPEL) packages are provided via Fedora COPR. Built with Redhat's UBI.

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ✅     |
| 🌐 [Web][WebClient]      | ✅     |

Supported: EPEL `9`, EPEL `10`

CentOS Stream, RedHat Enterprise Linux, AlmaLinux, Rocky Linux, and other [EPEL-supported](https://docs.fedoraproject.org/en-US/epel/getting-started/) distributions.

**Install:**

```shell
# Add Meshtastic COPR repos
sudo dnf config-manager --set-enabled crb
sudo dnf install epel-release
sudo dnf copr enable @meshtastic/beta
# Install meshtasticd
sudo dnf install meshtasticd
```

Docker</>}> Docker containers are provided via DockerHub.

Supported platforms: `linux/amd64`, `linux/arm64`, `linux/arm/v7`

**Debian:**

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ❌     |
| 🌐 [Web][WebClient]      | ✅     |

```shell
docker pull meshtastic/meshtasticd:beta-debian
```

**Alpine:**

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ✅     |
| 📱 [MUI][MUI]            | ❌     |
| 🌐 [Web][WebClient]      | ❌     |

```shell
docker pull meshtastic/meshtasticd:beta-alpine
```

See: [Docker Usage](../../docs/software/linux/usage/.html#usage-with-docker)

Flatpak</>}> Flatpaks are provided via FlatHub.

| Feature                  | Status |
| ------------------------ | ------ |
| 🔌 [USB Radio][USBRadio] | ✅     |
| 🕸️ [SPI Radio][SPIRadio] | ❌     |
| 📱 [MUI][MUI]            | ✅     |
| 🌐 [Web][WebClient]      | ❌     |

Supported platforms: `x86_64`, `aarch64`

Many distros support Flatpaks, see [FlatHub Setup](https://flathub.org/setup) for help getting started.

**Install:**

```shell
flatpak install flathub org.meshtastic.meshtasticd
```

**Run:**

```shell
flatpak run org.meshtastic.meshtasticd
```

OpenWrt</>}>

| Feature                  | Status |
| ------------------------ | ---------------------------------------------------- |
| 🔌 [USB Radio][USBRadio] | ✅                                                   |
| 🕸️ [SPI Radio][SPIRadio] | [⏸️](https://github.com/openwrt/packages/pull/26832) |
| 📱 [MUI][MUI]            | ❌                                                   |
| 🌐 [Web][WebClient]      | ✅                                                   |

Supported OpenWrt Versions: `SNAPSHOT`, `24.10`, `23.05`, `22.03`

Supported platforms:

  all the platforms!
  - aarch64_cortex-a53
  - aarch64_cortex-a72
  - aarch64_cortex-a76
  - aarch64_generic
  - arm_arm1176jzf-s_vfp
  - arm_arm926ej-s
  - arm_cortex-a15_neon-vfpv4
  - arm_cortex-a5_vfpv4
  - arm_cortex-a7
  - arm_cortex-a7_neon-vfpv4
  - arm_cortex-a7_vfpv4
  - arm_cortex-a8_vfpv3
  - arm_cortex-a9
  - arm_cortex-a9_neon
  - arm_cortex-a9_vfpv3-d16
  - arm_fa526
  - arm_xscale
  - armeb_xscale
  - i386_pentium-mmx
  - i386_pentium4
  - loongarch64_generic
  - mips64_mips64r2
  - mips64_octeonplus
  - mips64el_mips64r2
  - mips_24kc
  - mips_4kec
  - mips_mips32
  - mipsel_24kc
  - mipsel_24kc_24kf
  - mipsel_74kc
  - mipsel_mips32
  - powerpc64_e5500
  - powerpc_464fp
  - powerpc_8548
  - riscv64_generic
  - x86_64


See [Meshtastic on OpenWrt routers](../../docs/hardware/devices/openwrt/.html)