ChirpOnLinux » History » Revision 7
Revision 6 (Masen Furer, 01/25/2023 12:33 AM) → Revision 7/45 (Dan Smith, 03/09/2023 05:52 PM)
# Running CHIRP on Linux
This page describes how to get the newer python3-based CHIRP-next running on Linux.
## Debian, Ubuntu, Mint, Raspbian, etc
Install prerequisite packages:
```
$ sudo apt install git python3-wxgtk4.0 python3-serial python3-six python3-future python3-requests python3-pip
```
You should be able to install either the wheel or the tarball using `pip`:
```
$ pip3 install chirp-next-20230114.tar.gz
```
> **_NOTE:_** Your system may install `pip` as `pip3` like above, or just `pip`
If you run the above command as a regular user, the `chirp` executable will be installed into `~/.local/bin/chirp`. If you run it as root, then it will be in `/usr/local/bin/chirp` as you might normally expect.
### Create a desktop (menu) entry
A desktop entry can be placed in `/usr/share/applications/chirp.desktop` to have a menu entry added. Or it can be placed on the desktop itself to add an icon.
See the template desktop entry distributed with chirp: https://github.com/kk7ds/chirp/blob/master/chirp/share/chirp.desktop
If you have installed chirp for your user only, then update the paths for your home directory: `~/.local/share/applications/chirp.desktop`
```
[Desktop Entry]
Name=CHiRP-next (user install)
Comment=Program radios using CHiRP
Keywords=ham radio
Exec=.local/bin/chirp
Icon=.local/lib/python3.9/site-packages/chirp/share/chirp.ico
Terminal=false
StartupNotify=true
Type=Application
Categories=HamRadio
```
### (Optional) Newer `wxPython`
You may want to install a newer wxPython, depending on what your distro ships. For Debian-derived distros (including Ubuntu and Mint) you can do that with a command like:
```
pip3 install -U -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-20.04 wxPython
```
Check the [directory listing](https://extras.wxpython.org/wxPython4/extras/linux/gtk3/) for other distro versions and use the closest match to what you're on. **NOTE** that this will not work for non-x86_64 machines (like the Raspberry Pi) as there are no binary builds for those platforms.
## Python 3.11 issues
Right now (as of 9-March-2023), testing and released builds are based on <=3.10. If you want to run chirp on a distro with 3.11 you'll likely have to do some work on your own.
For issues with `attrdict` see [this github issue](https://github.com/wxWidgets/Phoenix/issues/2296).
## Serial port permissions
Note that you may need to adjust permissions on the /dev/tty(something) device, or add your users who want to use CHIRP to the **"dialout"** group in order to let non-privileged users access the serial device.
This issue is often indicated by an "access denied" error when accessing serial port.
On most Linux distros this is accomplished with:
```
sudo addgroup "$USERNAME" dialout
```
For other distributions, such as Manjaro, you may need to add your user to the uucp group.
You will then need to log out and back in for it to take effect.