Node Setup

Mass Mesh is a high-tech social club building community-owned mesh networks throughout Boston. Participating in the mesh allows you to band together with your neighbors to form a "mini-ISP," and get a better deal on your Internet.

You can join the mesh by setting up a mesh node at your home. In these instructions, we will cover how to deploy a mesh node that is privacy-enabled by default, and allows you to share an Internet connection with your neighbors. The whole setup process takes about 2 hours from start to finish. The necessary hardware is listed below, and instructions for everything from flashing the firmware to placing the mesh point are covered.

Note: Set yourself up for success, and introduce yourself in one of our chat rooms before you begin. Something will go wrong during the setup process, and it's best to have experienced friends ready to help when it does.

Preparation

Considerations

• Time: about 2 hours
• Cost: about $150
• Internet Access: If you do not already have Internet access, you will need to find a neighbor (on your same street) who is willing to set up a mesh node at their home too, and work out a deal to share their Internet connection fairly.
• Difficulty: The instructions contained on this website are quite technical, and may be incomplete in some places. Most of these instructions were written with Linux users in mind. If you are using another operating system (like Windows or Mac,) some "googling" may be necessary to get through them. As stated above, it's good to have friends. Introduce yourself in any of our chat channels if you want some help getting started!

Materials

Standard Mesh Node

To set up a standard mesh node that broadcasts a secure Internet connection in all directions, you will need to obtain the following equipment:

• 

  Ubiquiti UAP AC Mesh

• 

  RPF Raspberry Pi 4 Model B

• 

  microSD Card (4GB+)

• 

  Ethernet Cable (3x) (Three sections, cut to length)

• 

  USB to Ethernet Adapter (1+)

• 

  PoE Injector (One should come with the UAP AC Mesh if you buy it new)

• 

  One Paperclip (Seriously, these come in handy)

Custom Mesh Nodes

If you know what kind of hardware you want, and this 'aint it, please see the recommended Hardware Bundles, or browse the full list of Devices.

Firmware Installation

If you prefer, bring your hardware to one of our weekly meetups, and we will be happy to flash it for you!

Raspberry Pi 4

Materials & Software

Warning: Download and install the appropriate version of the Raspberry Pi Imager for your computer before continuing.

• 

  RPF Raspberry Pi 4 Model B

• 

  microSD Card (4GB+)

• 

  Ethernet Cable (1x)

Install the Firmware

1. Download the latest stable version of Mass Mesh's free firmware here
2. Open the Raspberry Pi Imager (Download and install it from here if you haven't yet.)
3. Select "Choose OS"
   1. 
4. Scroll to the bottom of the list, and select "Use Custom"
   1. 
5. Find the Mass Mesh firmware you just downloaded, and select it from the filesystem.
6. Once you have selected the appropriate firmware, select "Choose SD Card"
   1. 
7. You should see something like the following. Go ahead and select that card. (You probably only see one, but use the size of the card as a hint if you see several.)
   1. 
8. Once you have selected the OS and the SD Card, select "Write." You will see a warning like the one shown below... Go ahead and select "Yes."
   1. 
   2. 
9. You should see a screen like the following. Click "Continue," and remove the SD card from your computer.
   1. 

UAP AC Mesh

Materials

• 

  Ubiquiti UAP AC Mesh

• 

  Ethernet Cable (2x)

• 

  PoE Injector (One should come with the UAP AC Mesh if you buy it new)

• 

  One Paperclip (Seriously, these come in handy)

Configure Your Node

The pre-configured Mass Mesh firmware aims to have as much as possible done out of the box.

If you are using stock OpenWrt, see Manual Configuration for how to replicate our settings.

Install Your Node

In addition to providing power to the node, you may also want to use the following ports on your device:

• The WAN port (on multi-port devices) may be connected to a spare LAN port on your regular router (or directly to your modem) to share your internet connection with the mesh
• The LAN port may be connected to a switch or any device to provide internet to that device through the mesh

Tips For Best Results

In order to communicate on the mesh, your node must be able to talk to other nodes in your area. Here are some suggestions to help maximize your signal:

• Weather resistant nodes should be mounted on the outside of the house or to a column facing the street
• Indoor nodes should be placed on or near windows facing the street and other buildings
• Nodes will work best if they have a direct line of sight to each other

Seeking Assistance

If you need help at any point, get in touch with us online or in person.