fixup! wip iPad docs

Author: nhooyr

doc/ipad.md

@@ -1,7 +1,50 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 # iPad
 
-## How To Access The Self Signed Certificate on iPad
+- [iPad](#ipad)
+  - [How to access code-server with a self signed certificate on iPad](#how-to-access-code-server-with-a-self-signed-certificate-on-ipad)
+  - [Known Issues](#known-issues)
 
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
+# iPad
+
+## How to access code-server with a self signed certificate on iPad
+
+The following instructions assume you have code-server installed
+and running with a self signed certificate.
+
+If not, please first go through [./guide.md](./guide.md)!
+
+**warning**: Do not try to access your code-server instance before completing the below
+steps otherwise you may have to restart your iPad as Safari will refuse
+to connect to code-server even after you install the certificate.
+
+The below assumes you are using the self signed certificate that code-server
+generates for you. If not, that's fine but you'll have to make sure your certificate
+abides by the following guidelines from apple: https://support.apple.com/en-us/HT210176
+
+1. Your certificate **must** have a subject alt name that matches the hostname/ip address
+   at which you will access code-server from your iPad. You can pass this to code-server
+   so that it generates the certificate correctly with `--cert-host`.
+2. Share your self signed certificate with the iPad.
+   - code-server will print the location of the certificate it has generated in the logs.
+
+```
+[2020-10-30T08:55:45.139Z] info    - Using generated certificate and key for HTTPS: ~/.local/share/code-server/192_168_0_15.crt
+```
+
+- You can mail it to yourself or if you have a Mac, it's easiest to just Airdrop.
+
+3. When opening it, you'll get prompted that it is available to install in settings.
+4. Go to `Settings -> General -> Profile -> localhost` and then hit `Install`.
+   - You may be prompted to hit `Install` again
+5. Once installed, accessing code-server should work!
+
+If something goes wrong it's best to remove the profile, exit any tabs
+in Safari and restart the iPad. And then try again.
 
 ## Known Issues
+
+There are a few known issues with the iPad support.