Difference between revisions of "Node Setup"

Jump to navigation Jump to search
Line 1: Line 1:
Familiar with a terminal? This page will help you get your mesh node set up. You will first need to select a device and flash a firmware onto it - those instructions can be found on the device-specific page. Then, head back here to complete the rest of the set-up.
+
This page will help you set up your mesh node each step of the way. We have done plenty of research to provide you with informed recommendations on what works best.
  
== Communication Channels ==
+
== Choosing your Devices ==
Need help? Here's how to get in touch:
+
First, you will need to select and acquire the hardware components of your custom router. We have gathered information on many [[Compatible Devices|devices]] to make your selection easier.
* [https://riot.im/app/#/group/+massmesh:matrix.org Matrix Chat]
 
* [https://lists.riseup.net/www/info/massmeshnet Mailing List]
 
* [https://www.meetup.com/SomervillePirates/ Weekly Meetups]
 
* [https://www.loomio.org/join/group/GXbGqiAUZGUYeviQmnmydH3R/ Loomio]
 
 
 
== Choosing a Node ==
 
Take a look at our [[Compatible Devices|devices]] page. Because we are using Yggdrasil for encrypted routing, you will want to choose a device with an Yggdrasil speed that meets your needs.
 
  
 
== Flashing the Firmware ==
 
== Flashing the Firmware ==
The procedure to flash the firmware varies from device to device. If the device uses removable media, such as an SD Card, it may be easiest to use Etcher to write the image to the drive. Alternatively, flashing may require logging into the device and uploading the firmware file to the device while it runs.
+
The procedure to flash the firmware varies from device to device. The [[Compatible Devices|devices]] page contains links to wiki pages for each listed device.
  
Refer to the wiki page for your device to determine the flashing procedure, or bring your node to one of our meetings and have it flashed for you!
+
Refer to the wiki page for your device to find its corresponding flashing procedure. Or if you prefer, bring your node to one of our meetings and we will be happy to flash it for you!
 
 
When your device is flashed, return to these steps to continue.
 
  
 
== Configuring your Node ==
 
== Configuring your Node ==
Once your device has been flashed, there may be a few more steps to getting up and running. The preconfigured MassMesh firmware aims to have as much as possible done out of the box.
+
The preconfigured MassMesh firmware aims to have as much as possible done out of the box.
  
If using stock OpenWrt, see [[Manual Configuration]] for how to replicate the prebuilt firmware settings.
+
If you are using stock OpenWrt, see [[Manual Configuration]] for how to replicate the prebuilt firmware settings.
  
== Node Placement ==
+
== Placing your Node ==
 
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:
 
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:
  
* If the node is weather resistant, mount it on the outside of the house or to a column facing the street
+
* 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
 
* 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
  
== Wiring Up the Node ==
+
== Wiring Up your Node ==
  
In addition to providing power to the node, you may also want to use the following ports on the device:
+
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 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
 
* The LAN port may be connected to a switch or any device to provide internet to that device through the mesh
 +
 +
== Seeking Assistance ==
 +
If you need help at any point, [[Meeting and Contact Info|get in touch with us]] online or in person.

Revision as of 15:03, 23 October 2019

This page will help you set up your mesh node each step of the way. We have done plenty of research to provide you with informed recommendations on what works best.

Choosing your Devices

First, you will need to select and acquire the hardware components of your custom router. We have gathered information on many devices to make your selection easier.

Flashing the Firmware

The procedure to flash the firmware varies from device to device. The devices page contains links to wiki pages for each listed device.

Refer to the wiki page for your device to find its corresponding flashing procedure. Or if you prefer, bring your node to one of our meetings and we will be happy to flash it for you!

Configuring your Node

The preconfigured MassMesh 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 the prebuilt firmware settings.

Placing your Node

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

Wiring Up 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

Seeking Assistance

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