meshtastic/docs/development/firmware/port-numbers.mdx

---
id: portnum
title: Meshtastic Port Numbers
sidebar_label: Port Numbers
sidebar_position: 4
---

Any new app that runs on the device or via sister apps on phones/PCs should pick and use a unique "portnum" for their applications use.

The current list of port numbers can be found listed in the [protobufs](https://buf.build/meshtastic/protobufs/docs/main:meshtastic#meshtastic.PortNum)

## Assignment

PortNums should be assigned by the following ranges:

| Portnum | Usage                                                                                                                  |
| :-----: | :--------------------------------------------------------------------------------------------------------------------- |
|  0-63   | Core Meshtastic use, do not use for third party apps.                                                                  |
| 64-127  | Registered 3rd party apps, send in a pull request that adds a new entry to portnums.proto to register your application |
| 256-511 | Use one of these portnums for your private applications that you do not want to register publicly                      |

All other values are reserved.

## Integration

If you are making a new app using Meshtastic, please send a pull request to add your chosen "portnum" to this master table.