diff --git a/README.md b/README.md
index 23e83a9..420c086 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,5 @@
-# public-peers
+# Public Peers
+
+This repository contains peering information for publicly accessible nodes on the Yggdrasil network.
+
+In most cases, public peers should be accessible by adding the string provided for each peer to the `Peers: [],` list of your config file (comma separated).
diff --git a/asia/japan.md b/asia/japan.md
new file mode 100644
index 0000000..23c3060
--- /dev/null
+++ b/asia/japan.md
@@ -0,0 +1,9 @@
+# Japan Peers
+
+Add the strings from the below to the `Peers: [],` list of your config file (comma separated) to connect to these nodes.
+
+Tokyo, operated by [BAN AI Systems](https://ban.ai/)
+
+`"139.162.119.37:44478"`
+
+`"[2400:8902::f03c:91ff:fe1f:c32a]:44478"`
diff --git a/asia/singapore.md b/asia/singapore.md
new file mode 100644
index 0000000..43c5658
--- /dev/null
+++ b/asia/singapore.md
@@ -0,0 +1,9 @@
+# Singapore Peers
+
+Add the strings from the below to the `Peers: [],` list of your config file (comma separated) to connect to these nodes.
+
+Singapore, operated by [BAN AI Systems](https://ban.ai/)
+
+`"172.104.183.233:44478"`
+
+`"[2400:8901::f03c:91ff:fef5:264c]:44478"`
diff --git a/europe/france.md b/europe/france.md
new file mode 100644
index 0000000..23d7155
--- /dev/null
+++ b/europe/france.md
@@ -0,0 +1,7 @@
+# France Peers
+
+Add the strings from the below to the `Peers: [],` list of your config file (comma separated) to connect to these nodes.
+
+Paris, operated by [Arceliar](https://github.com/Arceliar)
+
+`"51.15.204.214:12345"`
diff --git a/europe/germany.md b/europe/germany.md
new file mode 100644
index 0000000..a830771
--- /dev/null
+++ b/europe/germany.md
@@ -0,0 +1,9 @@
+# Germany Peers
+
+Add the strings from the below to the `Peers: [],` list of your config file (comma separated) to connect to these nodes.
+
+Frankfurt, operated by [BAN AI Systems](https://ban.ai/)
+
+`"172.104.128.167:44478"`
+
+`"[2a01:7e01::f03c:91ff:fef5:a39b]:44478"`
diff --git a/europe/united-kingdom.md b/europe/united-kingdom.md
new file mode 100644
index 0000000..048607c
--- /dev/null
+++ b/europe/united-kingdom.md
@@ -0,0 +1,11 @@
+# UK Peers
+
+Add the strings from the below to the `Peers: [],` list of your config file (comma separated) to connect to these nodes.
+
+## England
+
+London, operated by [BAN AI Systems](https://ban.ai/)
+
+`"176.58.99.99:44478"`
+
+`"[2a01:7e00::f03c:91ff:fef5:2612]:44478"`
diff --git a/north-america/united-states.md b/north-america/united-states.md
new file mode 100644
index 0000000..2f086eb
--- /dev/null
+++ b/north-america/united-states.md
@@ -0,0 +1,19 @@
+# US Peers
+
+Add the strings from the below to the `Peers: [],` list of your config file (comma separated) to connect to these nodes.
+
+## New Jersey
+
+Newark, operated by [BAN AI Systems](https://ban.ai/)
+
+`"97.107.142.154:44478"`
+
+`"[2600:3c03::f03c:91ff:fe40:5199]:44478"`
+
+## Texas
+
+Dallas, operated by [BAN AI Systems](https://ban.ai/)
+
+`"198.58.100.240:44478"`
+
+`"[2600:3c00::f03c:91ff:feae:3efa]:44478"`
diff --git a/other/tor.md b/other/tor.md
new file mode 100644
index 0000000..25a400b
--- /dev/null
+++ b/other/tor.md
@@ -0,0 +1,18 @@
+# Tor hidden service peers
+
+Note that connecting to tor nodes isn't natively supported by yggdrasil-go (as of writing), so some trickery with nc/ncat/socat may be required.
+This will be documented later, but for now it's left as an exercise for the reader.
+
+## Nodes
+
+SHHS2 (TCP-only, Single Hop Hidden Service v2), operated by [BAN AI Systems](https://ban.ai/)
+`"bfq6x5pv5ifedihl.onion:44478"`
+
+SHHS3 (TCP-only, Single Hop Hidden Service v3), operated by [BAN AI Systems](https://ban.ai/)
+`"dbedawgprm7uot4fbfmmvoowpyshdsic7hhbcyxtkyblcuyr3eaiixid.onion:44478"`
+
+HS2 (TCP-only, Hidden Service, v2), operated by [BAN AI Systems](https://ban.ai/)
+`"trnszzzcbyt3c2sv.onion:44478"`
+
+HS3 (TCP-only, Hidden Service, v3), operated by [BAN AI Systems](https://ban.ai/)
+`"flnncw6fyuqqdnwv7m6grf4o4yw5afrcml6g5eyoucldi2oh34vlfzyd.onion:44478"`