IPIP Mesh/Encap.txt: Difference between revisions

Latest revision as of 19:08, 29 September 2026

An encap.txt file lists AMPRNet gateways, in a format like this:

# This is a comment
route addprivate 44.10.0.100/32 encap 136.115.52.224
route addprivate 44.100.129.0/24 encap 176.140.10.22

Originally formatted for JNOS systems, it is often parsed with a "munge script" to update Linux system routing tables.

Portal

To get an encap.txt file that lists all current gateways, request all routes from the Portal API and convert the response from JSON to text. For example (using API version 2):

curl -s -H "Authorization: Bearer $APItoken" -H "Accept: application/json" https://portal.ampr.org/api/v2/encap/routes | jq -r '.encap[] | select(.encapType == "IPIP") | "route addprivate \(.network)/\(.cidr) encap \(.gatewayIP)"'

A more complete example is in Encap.txt/get-encap.

If something goes wrong, the result won't be a complete list. Before using it to update routing tables, it's worth checking whether it has the right syntax and it's reasonably long. An empty list or a list that's much shorter than a previous version is probably erroneous.

HTTP

Previously, a complete encap.txt file was available from the Portal as a web page. This is no longer supported.

@@ Line 1: / Line 1: @@
-== The encap.txt file ==
+{{Section nav|hub=IPIP Mesh|title=IPIP Mesh|category=IPIP Mesh}}
-The encap.txt file is a file listing all the AMPRNet [[gateway| gateways]].
+An encap.txt file lists [[IPIP Mesh/Gateways|AMPRNet gateways]], in a format like this:
-Originally formatted for JNOS systems, it is often parsed with a "[[munge script]]" to update Linux system routing tables.
+ <nowiki># This is a comment
+route addprivate 44.10.0.100/32 encap 136.115.52.224
+route addprivate 44.100.129.0/24 encap 176.140.10.22</nowiki>
-The file can be obtained via the [[Portal| portal]] and private HTTP.
+Originally formatted for JNOS systems, it is often parsed with a "[[IPIP Mesh/Munge script|munge script]]" to update Linux system routing tables.
 == Portal ==
-You can create an API key on the portal by visiting [https://portal.ampr.org/profile.php your profile page]. Since it needs to be 32 characters I recommend using md5sum of any random data to generate it. The encap endpoint produces json format which you will need to format. You can then use the command line utilities '''curl''' and '''jq''' to turn this data into routes to ingest into about anything. For example for JNOS encap.txt format:
+To get an encap.txt file that lists all current gateways,
+request all routes from the [[API|Portal API]] and convert the response from JSON to text.
+For example (using [[API]] version 2):
-  curl -s -H "Authorization: Bearer <Portal API Key>" -H "Accept: application/json" https://portal.ampr.org/api/v1/encap/routes | jq -r '.encap[] | "route addprivate \(.network)/\(.maskLength) encap \(.gatewayIP)"'
+  <nowiki>curl -s -H "Authorization: Bearer $APItoken" -H "Accept: application/json" https://portal.ampr.org/api/v2/encap/routes | jq -r '.encap[] | select(.encapType == "IPIP") | "route addprivate \(.network)/\(.cidr) encap \(.gatewayIP)"'</nowiki>
+A more complete example is in [[IPIP Mesh/Encap.txt/get-encap|Encap.txt/get-encap]].
+If something goes wrong, the result won't be a complete list.
+Before using it to update routing tables, it's worth checking whether it has the right syntax and it's reasonably long.
+An empty list or a list that's much shorter than a previous version is probably erroneous.
 == HTTP ==
-This is still available on private HTTP but it is deprecated and also removed from the anonymous FTP. 44net list members can find the details in the mailman Archive in this thread:
+Previously, a complete encap.txt file was available from the Portal as a web page.
+This is no longer supported.
-[https://mailman.ampr.org/mailman/private/44net/2020-January/010633.html private gateway stats]
+[[Category:Reference]]
+[[Category:Infrastructure]]