Add basic Windows installation instructions

ultrahorizon · Jun 5, 2020 · d297cd0 · d297cd0
1 parent 18b3f94
commit d297cd0
Show file tree

Hide file tree

Showing 3 changed files with 55 additions and 4 deletions.
diff --git a/source/_static/icons/windows.png b/source/_static/icons/windows.png
diff --git a/source/clients/windows/index.rst b/source/clients/windows/index.rst
@@ -2,8 +2,16 @@
 Windows
 *******
 
-The UH VPN Windows application is currently in its final stages of development and is scheduled for
-release on 1st June 2020.
+.. image:: /_static/icons/windows.png
+  :height: 44
+  :alt: Download for Windows
+  :align: center
+  :target: https://uh-vpn.s3.amazonaws.com/clients/windows/uh-vpn-installer_1.0.0.msi
 
-Once this application has been released, this section will be updated accordingly with instructions
-for end users.
+The UH VPN Windows application can be downloaded by clicking the AppStore badge at the top
+of the page. The sections below detail specific instructions on how to use the Windows application.
+
+..  toctree::
+    :maxdepth: 1
+
+    installation
diff --git a/source/clients/windows/installation.rst b/source/clients/windows/installation.rst
@@ -0,0 +1,43 @@
+Installation
+============
+
+Upon downloading the MSI Installer, double click on it to install UH VPN.
+
+You may recieve a "Windows protected your PC" SmartScreen warning when
+launching the installer.  Click on "More Info" and then a "Run anyway" button
+will appear allowing you to continue with the installation.
+
+Verifying the Installer File (Advanced Users Only)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To verify the installer you can check the SHA256 hash with PowerShell.  Either
+navigate to the file in PowerShell, or navigate to the file in Windows Explorer
+and hold Shift and Right Click, and select "Open PowerShell window here".
+
+Once in PowerShell and in the same folder as the MSI installer, run the following
+command:
+
+.. code-block:: bash
+
+    Get-FileHash .\uh-vpn-installer_1.0.0.msi
+
+The output should be as follows, pay close attention that the Hash is exactly
+the same.
+
+.. code-block:: bash
+
+    Algorithm       Hash                                                                   Path
+    ---------       ----                                                                   ----
+    SHA256          32361FCCF91C9D491AD790011CBC529DEC39A0F33EF10B0862BF939A7C4C089A       uh-vpn-installer_1.0.0.msi
+
+
+Alternatively, one can right click on the MSI in Windows File Exporer and select
+"Properties".  In the properties dialog, select the "Digital Signatures"
+tab, then "Details" for the signature, then "View Certificate".
+
+In the Certificate dialog go to the "Details" tab, and find the
+"Thumbprint".  It should match:
+
+``ccaef34bfe6f8c8d180b240392487f4de45ed887``
+
+If you have any further questions feel free to raise an issue on our [issue tracker](LINK).