Skip to main content

Introduction

Mesh Logo.png

NYC Mesh is a community network. This means that city residents take it upon themselves to maintain and grow the network. A massive amount of cooperation between many different people with many different skills is required to accomplish this, and this website is here to make sure that individuals who want to improve the network can get the knowledge and skills they need to do so.

About NYC Mesh

We are a community network offering fast, affordable, and fair access to the Internet for all New Yorkers. By joining NYC Mesh, you can access the Internet while simultaneously helping your neighbors get better, safer Internet access, too. Adding an NYC Mesh connection to your apartment or building can serve as a backup Internet connection in case your commercial Internet service goes down.

As a community network, city residents such as yourself take it upon themselves to maintain and grow the network. This means that in addition to accessing the Internet, you can also make friends, meet neighbors, and learn valuable technical and computer skills by participating in our active community, either in-person or online. We regularly host face-to-face meetups, and you can join our Slack chat. Both are great places to ask questions and otherwise connect with our active community.

About this Website

The NYC Mesh Docs website is the central clearinghouse for technical information about our network. Here, we describe the implementation of specific [nodes]({{< relref "nodes" >}}), document [installation procedures]({{< relref "installs" >}}), and more. This website is not a networking tutorial, so readers are expected to have some basic familiarity with computer internetworking concepts to take full advantage of the material we present here, but we do strive to provide links to good educational resources for newcomers where it makes sense to do so.

There are a couple of different ways that you can make use of this website.

  • Like a book: You can read the entire website "front to back." Use the navigation menu to proceed from one section to the next, in order. This will give you a good idea of how our network works and how you can help us improve and maintain it.
  • Like a reference: You can skip directly to a section that interests you, or use this website to look up answers to specific questions that you have. This comes in particularly handy during an install or when troubleshooting issues.

Moreover, this website itself is part of the community network and is maintained by volunteers. That means you can help us improve it by adding missing information, clarifying confusing points, or even just fixing typos you notice while you're reading. To learn more about how you can contribute to and edit this website, see our docs README file.

Who should read this website

This website contains information about the technical implementation of the NYC Mesh network itself, along with ancillary information about the standard operating procedures (SOPs) of various NYC Mesh volunteer teams. Before reading this website, please read our FAQ. Many common questions are answered there, and this documentation is mostly written with the assumption that readers are already familiar with the answers to our most frequently asked questions.

Once you have already read our FAQ, then you should consider reading or referring to this website if:

  • you want to help expand the network by physically installing new nodes,
  • you have computer networking experience and want to help improve the network's performance or security,
  • you plan to volunteer to monitor or otherwise maintain the network and have questions regarding the configuration of various hardware and software components, or
  • you are interested in knowing details about how NYC Mesh functions that are not already covered by the FAQ.

You should not read this website if:

  • you want us to connect your apartment, house, or building to the mesh. Instead, please go to our Get Connected (join request) form where you will be put in contact with one of our install teams.
  • there is a problem with your connection and you need assistance from an NYC Mesh volunteer technician. Please use our Request Support form to open a trouble ticket to get help with problems you cannot fix on your own.
  • you are a member of the press seeking the latest news about NYC Mesh. We publish press releases specifically for journalists on our main website's Press page.
  • you are a member of the general public and are simply curious about our work. For this information, please read the Frequently Asked Questions (FAQ) page on our main website, returning here only if the FAQ does not satiate your curiosity. :)

We are always excited to welcome new volunteers who want to help us continue providing affordable, fair, and fast Internet connectivity to our fair city and so we hope you find this guidebook useful.