Skip to main content

Serving Docs Locally for Development


Some things won't display properly like logos or protobufs page, this is not cause for concern.


In order to set up your local environment, you will need to install:

Getting Started

Fork the Meshtastic Repository

Log into GitHub and create a fork of the meshtastic/meshtastic repository.

Clone your Meshtastic Repository fork


Replace username with your GitHub username.

Clone username/Meshtastic Repo
git clone

Change directory to Local copy

Change Directory
cd ~/meshtastic

Install Dependencies

Install dependencies using pnpm
pnpm i

Run Development Server

Run node.js server
pnpm start

Before submitting a pull request, it's helpful to run the following command to ensure there are no broken links or errors:

Build Project
pnpm build

Update Local Repository

Verify Upstream Remote is Set

Check Remote and Upstream Repositories
git remote -v

If it's set, skip to Align with meshtastic/meshtastic Master branch

Update/Set Upstream if it isn't configured properly

If upstream exists, set the URL:

Update Upstream Repository
git remote set-url upstream

If upstream doesn't exist, add the URL:

Add Upstream Repository
git remote add upstream

Align with meshtastic/meshtastic Master branch


This will delete any unfinished work. Make sure that you've saved and committed any work you wish to push up to your fork.


The following command assumes the clone of your Meshtastic fork is in the home directory (~/meshtastic). Adjust the path to the correct path on your machine.

Rebase local Meshtastic to remote Meshtastic
cd ~/meshtastic ; git fetch upstream ; git checkout master ; git rebase upstream/master