# Linux

## Update your OS

First, update your OS

```
sudo apt update
sudo apt upgrade
```

## Access to USB Serial

Add your user to the dialout group, change `$USER` to your user name. This allows your user to access the USB serial device.

```
sudo usermod -a -G dialout $USER
```

You'll need to logout and back in again.

## Flash the companion

> [!NOTE]
> If you've already flashed your companion with the MeshCore firmware you can skip this step.

> [!IMPORTANT]
> Make sure you flash with "Companion USB" not "Companion Bluetooth"

TODO

## Install needed software

Install pipx then meshcore-cli

```
sudo apt install pipx
pipx install meshcore-cli
```

Logout and back in again.

## Find the USB device

```
meshcli -l
```

Output probably looks like this, you'll want to use the USB one:

```
BLE devices:
 No BLE HW

Serial ports:
 /dev/ttyS0         n/a [n/a]
 /dev/ttyUSB0       CP2102 USB to UART Bridge Controller - CP2102 USB to UART Bridge Controller [USB VID:PID=10C4:EA60 SER=0001 LOCATION=1-1]
```
## Configure node

```
set radio 915.800,250,11,5
set name "🦷 dave test"
```