Advanced Search
Search Results
220 total results found
Introducing NYC Mesh Wiki
This page is intended as a catch page for people who follow old docs links which no longer lead anywhere. NYC Mesh Wiki has replaced NYC Mesh Docs: If you've landed on this page, you were probably trying to follow a link to something on nycmesh.net/docs. That ...
How to assign a "vanity" network number
These instructions are only needed when precise control of the exact NN is required. Most installs should just use the standard network number assignment form Network numbers uniquely identify devices on the NYC Mesh network. They are used to compute IP addr...
How to avoid manually entering latitude/longitude/altitude when constructing Node objects
When constructing or editing Node objects, users are presented with the following fields: Since manually locating these coordinates is tedious, MeshDB is able to automatically populate these fields from the Building object. To use this feature, simply scrol...
How to add potential Hubs and Links to the map
To add potential hubs and links to the map using MeshDB, you must create the appropriate database objects. The right way to do this depends on the current state of the data in the database, and the desired outcome. This page summarizes how to do various common...
How to update MeshDB when an install is completed
When an install is completed, there are a few items to confirm are correct in MeshDB so that we have accurate information and an up-to-date map: Confirm that a network number has been assigned to the install (this is probably already done by the installer, ...
How to update MeshDB to indicate the loss of an install
When an install leaves the mesh, MeshDB needs to be kept up-to-date to ensure we have accurate member count and contact information. If an install has just dropped offline for a few hours, no action is needed. MeshDB does not attempt to track the status of t...
New Application Integration Guide
So you want to build an application which interacts with MeshDB data. Great! First, familiarize yourself with the data schema that we use at a high level. You likely don't need to get into the intricacies of the various edge cases, but read the first section...
Environments
We run multiple instances of MeshDB. This is so that we can do development and testing, gate our changes, and ensure the quality of the code and configurations we ship. Find our infrastructure at nycmeshnet/k8s-infra Production (prod1/prod2) https://db.nycm...
Maintenance Mode
MeshDB has a maintenance mode. It prevents all access to the site, UI, and API while active. To enable it, run `manage.py enable_flag MAINTENANCE_MODE` or POST to the `/maintenance/enable/` route To disable it, run `manage.py disable_flag MAINTENANCE_MODE` o...
Observability
We use Datadog to monitor MeshDB. Dashboard https://p.us5.datadoghq.com/sb/4614e554-06a1-11ef-b43a-da7ad0900005-ba514715f9683f103794ee705df1db95 APM & Tracing Presently, MeshDB is instrumented at the deployment level with Single Step APM. Meshforms i...
Admin Panel
Feature Flags
We use a library to control whether certain features are enabled. To enable a feature, go to Flag States, create a new state, or edit the existing one, and fill it out like so. The feature will then be enabled.
Panoramas
The way that panoramas currently work in MeshDB sucks. They are uploaded to a github repo (https://github.com/nycmeshnet/node-db/tree/master/data/panoramas) manually. Once every now and then, MeshDB runs a celery job to query this GitHub and mutate the content...
Organization Domains
NYC Mesh uses various domains for network operation and to provide content about NYC mesh to the public. The second level DNS zones for NYC Mesh owned domains are hosted in name.com. The DNS zones are managed via terraform in the nycmeshnet/nycmesh-dns reposit...
WireGuard VPN Setup Guide
Originally written by JohnB in 2024-09 This is an attempt to document the setup process and the lessons from that process, both for setting up a personal phone connection to the Mesh as well as setting up an Omni in Queens that connects back to the Mesh via...
Compute Plan - 2024/10/08
During Hack Night, Scott, Zach, Willard, Andrew, and James discussed the layout for our compute in a few datacenters. Zach wants to set up redundant software routers using pairs of r640's he bought. He ended up giving us a pair to run a production environment...
Sending email notifications to members
This guide details the process to send emails to all the members that will be affected by maintenance work or other tasks that may cause an outage or slow speeds for members. The goal is to notify affected members ahead of time to ensure they are not caught b...
Hotspot Omni Configuration Guide
This guide applies to a specific Omnitik device that is configured for use as a mobile WiFi hotspot at outreach, tabling and other community events. This configuration and guide is not applicable to general use devices around the mesh and shouldn't be applied...