aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/contrib/examples/android/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/examples/android/README.md')
-rw-r--r--contrib/examples/android/README.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/contrib/examples/android/README.md b/contrib/examples/android/README.md
new file mode 100644
index 0000000..943d5f2
--- /dev/null
+++ b/contrib/examples/android/README.md
@@ -0,0 +1,21 @@
+# Tools for Android
+
+This currently contains a version of wg-quick.bash that works with
+Android 7's `ndc` command. It requires the WireGuard module to be
+part of your kernel, but after that, the usual `wg-quick up` and
+`wg-quick down` commands work normally.
+
+## Installation
+
+Build a `wg` binary for Android and place it in this folder. Then
+copy this folder some place on your phone, and run `sh ./install.sh`
+as root. It should survive ROM flashes.
+
+## Usage
+
+Compared to the ordinary wg-quick, this one gains a "DNS =" field,
+but loses SaveConfig and {Pre,Post}{Up,Down}.
+
+Put your configuration files into `/data/misc/wireguard/`. After that,
+the normal `wg-quick up|down` commands will work.
+