Feb 21: Launched "Snow Crash" release candidate v.0.1.0 - now deploying the first batch of experimental nodes!
Oct 25: Launched PeoplesOpen.net our public project page!
We are a group of volunteers building a community mesh network in Oakland, California.
A mesh network is, in essence, free as in freedom alternative internet. Using low-cost routers mounted on rooftops and outside of homes, we're currently building the backbone of the mesh throughout the East Bay, from West Oakland to the Fruitvale BART and beyond!
Mesh networks are awesome because they don't depend on the existing centralized Internet Service Providers to function. Though they can be connected to the Internet as we know it now, a mesh network provides a decentralized mode of communication with our local community. We view mesh networks as a means of connecting to our neighbors, supporting local businesses, and enabling grassroots community collaboration. In the event of disaster or government censorship, an active mesh network is a resilient means of communication and sharing of information.
|Oakland||Walkthrough||Meetings||Legal||How to Help||sudo mesh map|
|Documentation||Network topology||Swag||Server security|
- 1 Meetup Info
- 2 Crowdfunding campaign
- 3 Mesh pages
- 4 Firmwares / groups
- 5 Technical overview
- 6 Social
- 7 Meeting Minutes
- 8 Web Resources
- Join the Mailing List!
- We have weekly hack nights on Thursdays, 7:30-10pm at Sudo Room. The first three Thursdays of the month are work nights - so come by and jump in! General meetings for discussion and planning are Last Thursdays of every month. We plan to have local focus groups in the near future - watch this space or join the mailing list for details.
- Find us on IRC: #peoplesopen.net on Freenode IRC
- We generally take meeting notes at: https://pad.riseup.net/p/sudomesh
In July 2013, we successfully concluded our bootstrap crowdfunding campaign on WePay to buy the first 100 wifi routers for the mesh! Thanks to all who supported with a donation. See Mesh/Purchases for details on how much was raised, who contributed, and what we've procured thus far with the funds!
Here are some other ways you can help out:
- Support us with a small weekly donation on Gittip.
- Send bitcoins to our wallet address: 12RxU4DpLpdWcmEBn7Tj325CCXBwt5i9Hc
- Come to our work meetings in Oakland! (listed above).
- Form a project and/or a neighborhood working group to create new and locally-relevant ways of plugging into the mesh.
- Mesh/ToDos - Tangible To Dos! Add some on, take some on!
- Mesh/Wishlist - List of hardware we'd love to experiment with!
- Map - of potential nodes.
- Mesh/Website - Notes and documentation for the design of peoplesopen.net and meshthepla.net.
- Mesh/MeshApps - Local applications to run on the mesh!
- Mesh/Swag - Research on custom-printed t-shirts and other swag.
- Mesh/Stickers - Sticker design
- Ascii Art - for linux logins
- Mesh/Tracking - Problems and solutions related to tracking, logging and anonymity
- Mesh/WalkThrough - Easy how-to for setting up OpenWRT & BATMAN-adv on Ubiquiti routers
- Mesh/Firmware - Everything related to our firmware
- Mesh/Firmware/Splash page - Splash page / Captive Portal
- Mesh/Firmware/Bandwidth shaping - QoS / Bandwidth shaping
- Mesh/Firmware/Zeroconf - Issues related to mDNS and DNS-SD
- Mesh/Firmware/MTU_issues - MTU issues
- Mesh/Firmware/Generating - How do we generate firmwares on demand
- Mesh/Firmware/Web Admin Development - Web admin development
- Mesh/Network topology - High-level explanation of the mesh network structure
- Mesh/Specs - Specs sheet on different access points
- Mesh/Frequencies - Information on different frequencies.
- Mesh/Software tools - List of useful mesh troubleshooting tools
- Mesh/Terms - Hidden Node, Fresnal zone, and other jargons
- Mesh/Power - Stuff about power usage, batteries and solar power.
- Mesh/Monitoring - notes about how to monitor systems
- Mesh/Spectrum - Different forms of spectral analysis
- Mesh/Hardware support - Officially and unofficially supported hardware / routers
- Mesh/Relay setup - Setting up a relay node
- Mesh/Exit setup - Setting up an exit node
- Mesh/Spectrum mapping - The setup we use for mapping local spectrum and wifi usage
- Mesh/Spectrum mapping/XO-1 Laptop - How to configure an XO-1 laptop for use with our spectrum mapping setup
- Mesh/Install - physical installation notes/stories
- Mesh/Legal - How do we use exit nodes, relays and legal structures to protect node owners and ourselves?
- Mesh/Hosting - How are we hosting and what does it cost?
- Mesh/Backup - How do we handle backups?
- Mesh/Server security - How do we ensure server security?
- Mesh/Naming - What do we call ourselves?
- Mesh/Marketing - Inspiration and links to marketing materials in progress.
- Mesh/Purchases - Details on our purchases, made by either individuals or through our crowdfunded money.
- Mesh/Inventory - What we currently have.
- Mesh/Donations - List of donations
- Mesh/Decisions - Decisions on how to operate
- Mesh/Challenges - Challenges faced. Problems to be solved.
- Mesh/Checkouts - Who took what gear home
- Mesh/Funding - Ideas on funding structures and list of grants to apply for.
- Mesh/Interviews with other meshers - In which we attempt to extract the results of their hard-won experience.
- Mesh/Other mesh projects - List of active and inactive meshes we know about
- Mesh/Documentation - Books, articles, wikis, blog posts.
- Mesh/Oakland - Information and resources pertaining to Oakland community organizations, wireless initiatives, policy and research initiatives
- Mesh/Other muni networking projects - Examples of progressive uses of muni-networks
Firmwares / groups
The mesh is made up mostly of wifi routers using Atheros chipsets and running our own firmware based on OpenWRT, B.A.T.M.A.N. Advanced and wlan slovenja's tunneldigger. We're using 2.4 GHz routers for indoor and street-level coverage and 5 GHz 802.11n routers for high-bandwidth and long distance roof to roof links. Most of our outdoor equipment is from Ubiquiti. We refer to the wifi routers as mesh nodes, or simply nodes.
Node-owners can choose to connect the nodes to their existing LAN using ethernet. If they have Internet access, they can share a portion of it with the mesh. The amount of bandwidth shared is limited with 'tc'. It is chosen at node-configuration time and can be changed using the simple built-in web admin interface.
Wifi networks and IP assignment
The nodes each run three wifi networks (three SSIDs on the same physical wifi interface):
- peoplesopen.net is an open access point. Most people will use the network by connecting to this.
- pplsopen.net-node2node is an ad-hoc network that the nodes use to mesh with each other
- A private wifi network is named by the node owner (or a name is generated) and uses WPA2-PSK.
If a node-owner is sharing internet, then the node will create a layer 2 (L2TP) tunnel to a VPN server on the Internet using tunneldigger. batman-adv will connect over this tunnel to other nodes on the mesh, so the mesh can route traffic over the internet if no wifi path to another node is available (e.g. other nodes are physically too far away). When people connect to the peoplesopen.net access point and try to access the Internet, the traffic will flow through the VPN, and the source IP of requests will appear to be the VPN with the sudo mesh organization listed as the abuse contact.
The nodes run DHCP servers and each have a /24 IPv4 subnet in the 10.0.0.0/8 range that is statically assigned by coordination between mesh groups and individuals hosting and administrating their own nodes on People's Open Network (currently only the sudo mesh organization). If a user connects to the peoplesopen.net access point on a node that isn't sharing internet, then batman-adv intercepts the DHCP request and forwards the request to another node on the network that has Internet connectivity (see the gw_mode option for batman-adv).
The private network does not limit bandwidth and provides access to both direct access to the Internet (if the node owner has hooked the node up to the Internet) and access to the mesh. Each node's private network runs on 172.30.0.0/16 and uses NAT between the private network and the mesh. It does not accept any new incoming connections from the mesh onto the 172.30.0.0/16 subnet.
Node flashing and configuration
One of our medium-term goals is to be able to sell nodes on our website and minimize the amount of work required to re-flash/configure the nodes and provide documentation for the user. To facilitate this, our current process for new nodes is:
- A new node is flashed either automatically (using e.g. ubiquiti-flasher or merakiflasher) or manually with the sudowrt firmware.
- The node is plugged into a server running our node-configurator software.
- A sudo mesh volunteer pulls up https://nodeconf.local and uses a web interface to fill out contact info for the node owner, initial bandwidth sharing limits and private wifi SSID.
- The node-configurator generates SSH keys, SSH root password, web admin password and private wifi password, then it configures the node, saves the info in the node database and shuts down the node.
- The node-configurator automatically prints a sticker containing some basic info including wifi and web admin passwords.
- The sudo mesh volunteer attaches the sticker to the nodes power supply and puts the node back in the box with a set of instructions for how to install and use the node.
- The node is shipped to the new node owner!
The node-configurator has both a server and a client component. The newly flashed sudowrt nodes automatically run the node-configurator client when they boot, and the client uses DNS-SD and mDNS to find node-configurator servers on the local network. The node then connects to the server using SSL and the server is ready to configure the node. The node-configurator server talks to Avahi using DBUS to announce itself using DNS-SD. The server is written in Python using Twisted and the client is written in Lua using luasec, and uses the mdnssd-min utility to provide DNS-SD and mDNS.
The node-configurator includes a webserver and management web app. The web app talks to the server and connected nodes using websockets.
All nodes set up by sudo mesh automatically allow root access using an SSH key held by a few trusted sudo mesh organizers. This is to allow us to update the firmware and troubleshoot network issues. We inform node-owners of this fact and tell them how to prevent sudo mesh from accessing their nodes, but also indicate that they should be ready to manage their own node if they choose to do this.
We don't yet have a solution for node monitoring but we're expecting to use the new version of wlan slovenja's nodewatcher software.
We don't yet have an automatic update solution in place, but it will work similarly to the node-configurator:
- Any number of node-updater servers announce themselves on the mesh and whether or not an update is available.
- The nodes run a future version of mdnssd-min as a daemon that keeps a currently list of node-updaters.
- Once every N hours +/- a random factor, if any node-updaters have updates available, all nodes connect to a randomly chosen node-updater and request an update.
- The node-updaters send the nodes an ipk file with the update and the nodes check the signature and install it if it's signed by a trusted authority.
Minimum hardware specs
The sudowrt firmware minimally needs:
- Atheros chipset
- 32 MB ram
- 8 MB flash
- (or 4 MB flash and a USB port with a USB drive attached)
The firmware is currently only tested to be working on the older Atheros chipset (OpenWRT "atheros" architecture) but we're working on getting the newer Atheros chipsets working (OpenWRT "ar71xx" architecture).
We don't support less than 32 MB of ram because OpenWRT itself doesn't support less than 32 MB of ram as of the 12.09 "Attitude Adjustment" release.
We could probably squeeze the firmware into 4 MB flash, but we've decided it's not worth the trouble, and using jffs instead of squashfs simplifies some things.
We encourage node-owners to share their internet with the mesh, but on top of that we are talking to local non-profit organizations and ISPs about getting access to more cheap and free bandwidth.
Community-Based Participatory Action Research in the San Antonio district of Oakland
- We are currently researching existing community organizations in the San Antonio neighborhood for potential collaboration, and have established relationships with (and set up mesh nodes for) three grassroots organizations in the San Antonio neighborhood: Liberating Ourselves Locally (LOL), a makerspace run by and for people of color; Sustaining Ourselves Locally (SOL), a community garden and food justice advocacy and education space; and Cycles of Change, a community bike repair, advocacy and education space. Moving forward, we intend to expand the mesh through reaching out to grassroots organizations and local businesses, our process of designing and deploying mesh services guided by the needs and desires of existing community actors.
- The ethnographic research component of the project also involves interviewing local residents, designing and distributing community surveys, historical and political analysis, and asset mapping of existing and potential community resources.
Documentation of use cases and user stories
- Articulating use cases for mesh networks involves the creation of user stories based on interviews with local residents and participatory engagement with existing community organizations and groups. The research process will be transparently documented on a research wiki, incorporating interview notes, meeting minutes, an annotated bibliography, written analysis and visual infographics (for an example, see Jenny's current research wiki here: http://wiki.tidepools.co).
- This documentation is intended to support a model of open source technology design that is bottom-up in nature, rooted in the interests of those who would receive the greatest humanitarian benefit from the technology and participate intimately with the development process.
Illustrated instructables for adapting recycled/reused items for DIY hardware
- A major focus of the project is to experiment with recycled and donated hardware for the purposes of designing mesh solutions at minimal cost. Experimentation with various firmwares (eg; Commotion, Freifunk, Byzantium) and protocols (eg; OLSRd, batman-adv, Babel) using off-the-shelf and upcycled hardware (eg; donated routers and satellite dishes) will be extensively documented. Well-designed instructables/comics will incorporate use cases, user stories, and DIY building processes in an effort to engage everyday folks to experiment with mesh technology in their local neighborhoods.
Getting municipal actors to support the mesh
- Over time, we expect municipal actors (people working for local governments, libraries, schools, etc.) to see the mesh as an ally in efforts to bridge the digital divide. We are creating a short introduction to the project explaining why municipal actors should care about the mesh what they can do to support it.
See the Minutes page.
- 510pen - East Bay community wireless mesh network spawned in 2009 by Mark Burdett
- Tidepools - Jenny Ryan designed local use cases for a community mobile mapping application built to run on mesh networks.
- Project Meshnet - Extensive wiki on the /r/darknet project, including extensive list of projects coordinating with them.
- Long Range Wifi - Info on the longest-range wifi connections ever made.
- Adafruit's Web IDE built for Raspberry Pi but probably good for editing code on any device and ensuring it is managed with a code repo. By default it uses bitbucket.org but it could probably be configured for Github.