From a8fc858d4d2da768f02a7392bd829443cb0c52d8 Mon Sep 17 00:00:00 2001
From: John Knox <jknox@fb.com>
Date: Tue, 29 Jan 2019 08:52:31 -0800
Subject: [PATCH] Add custom ports to documentation

Summary:
Added instructions on using custom ports.

We probably want to put the headless instructions here too when they're ready.

Reviewed By: danielbuechele

Differential Revision: D13860469

fbshipit-source-id: 76537a36e6fc85e805a29830927e4d59ee4f73e8
---
 docs/custom-ports.md  | 27 +++++++++++++++++++++++++++
 website/sidebars.json |  3 ++-
 2 files changed, 29 insertions(+), 1 deletion(-)
 create mode 100644 docs/custom-ports.md

diff --git a/docs/custom-ports.md b/docs/custom-ports.md
new file mode 100644
index 000000000..a937f02ba
--- /dev/null
+++ b/docs/custom-ports.md
@@ -0,0 +1,27 @@
+---
+id: custom-ports
+title: Running Flipper with different ports
+sidebar_label: Using different ports
+---
+
+By default Flipper runs its servers on ports 8088 and 8089, and the mobile SDKs look for servers on those ports.
+
+Each of these can be overridden by setting an environment variable, with the format `${INSECURE_PORT},${SECURE_PORT}`.
+
+To run the desktop app using custom ports:
+
+```
+FLIPPER_PORTS=1111,2222 ./flipper
+```
+
+To configure the Android SDK for custom ports, set the `flipper.ports` prop to your chosen ports `1111,2222` like so, and then launch the Android app.
+
+```
+adb shell
+su
+setprop flipper.ports 1111,2222
+exit
+exit
+```
+
+To configure the iOS SDK for custom ports, set the FLIPPER_PORTS environment variable in your app launch script.
diff --git a/website/sidebars.json b/website/sidebars.json
index f3ad5e99b..9ee31d744 100644
--- a/website/sidebars.json
+++ b/website/sidebars.json
@@ -29,6 +29,7 @@
       "error-handling",
       "testing"
     ],
-    "Flipper Internals": ["establishing-a-connection"]
+    "Flipper Internals": ["establishing-a-connection"],
+    "Advanced Usage": ["custom-ports"]
   }
 }