Skip to content
Jason Fesler edited this page Dec 9, 2017 · 11 revisions

Welcome to the wiki for the Falling-Sky project. is an open-sourced web site dedicated to helping end users identify whether or not their IPv6 is working; and whether specific detectable errors are found. This is meant to be useful both to end users (with reasonably friendly terminology and explanations); as well as useful to help desks (particularly, the "Help Desk" tab is meant for concise reading over a phone for tech support).

This project is primarily JavaScript based. Most of the work is done in the user's browser; more specifically, we are actually testing the user's browser. Any circumstances that affect their ability to use the internet (or any workarounds made by browsers) are found here; and we show the user the end result.

A few parts of this are server-side; including both PHP helper scripts, and a custom Apache module that is crucial to the operation of the JavaScript client. This Apache module (mod_ip) quickly returns to the clients what address was detected, as well as additional details that we need server-side logic to fill (such as type of IP address and ISP name).

As of Feb 21 2015, this project now requires Linux. The mtu1280d daemon for testing PMTUD testing coordinates with linux ip6tables. There is no alternative at this time for other operating systems, as they lack the ability to allow user applications to filter incoming packets.

As of Dec 9, 2017, I have plans on adding SSL.. This will have impact to those operating a TransparentMirror. Please see SSL-and-HTTP-2-plans.

This site is open source. We encourage public mirrors; installation instructions are the the bulk of this wiki. We also encourage you to fork and adapt this for your own business needs. While we would encourage you to feed back code (or even just ideas/lessons learned), there is no legal obligation to do so.

About the name: IPv6 has been around for the last decade; however, industry has mostly ignored it. IPv4 will never run out of IP space! And the people advocating IPv6 have been considered to be at the heart of the story of Chicken Little. Now that IPv4 really is running out, and that IPv6 is really being deployed in a commercial sense, we have some need for end users to test their configuration, and perhaps get a few hints on what to do next.

You can’t perform that action at this time.