dosc/sc5: rework installation docs

This patch makes install section for each of the platforms. This gives a nice structure.

Linux, macOS, and Windows instructions were rewritten.
Docker and Kubernetes instructions were only moved, the content needs to be reworked.

Fixes SC-4583

Author: Choraden

docs/secure-connections/sauce-connect-5/installation.md

@@ -1,27 +1,22 @@
 ---
 id: installation
-title: Downloading Sauce Connect Proxy 5
-sidebar_label: Install
+title: Install Sauce Connect 
+sidebar_label: Installation
 ---
 
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import ScTable from '../../../src/components/scTable.jsx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
+### Installation Instructions (recommended)
 
-:::caution
-See [this document](/secure-connections/sauce-connect/installation/) for the most recent Sauce Connect 4.x.x version download instructions.
-:::
+Visit the following pages for installation instructions for your platform:
+- [Linux](/secure-connections/sauce-connect-5/installation/linux)
+- [MacOS](/secure-connections/sauce-connect-5/installation/macos)
+- [Windows](/secure-connections/sauce-connect-5/installation/windows)
+- [Docker](/secure-connections/sauce-connect-5/installation/docker)
+- [Kubernetes](/secure-connections/sauce-connect-5/installation/kubernetes)
 
-This topic describes how to install Sauce Connect Proxy version 5 to your machine.
+### Download Links 
 
-## What You’ll Need
+If you prefer to do custom installation, you can download Sauce Connect binaries from the following links.
 
-- A Sauce Labs account ([Log in](https://accounts.saucelabs.com/am/XUI/#login/) or sign up for a [free trial license](https://saucelabs.com/sign-up)).
-
-## Downloading Sauce Connect Proxy
-
-Download the latest Sauce Connect Proxy 5 to your local machine by clicking the link below corresponding to your OS and the CPU architecture.
 SHA256 checksums are available [here](https://saucelabs.com/downloads/sauce-connect/5.0.0/checksums).
 
 <table>
@@ -64,154 +59,21 @@ SHA256 checksums are available [here](https://saucelabs.com/downloads/sauce-conn
     </td>
   </tr>
   <tr>
-    <td>Windows x86_64</td>
+    <td>macOS</td>
     <td>
-      <a href="https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.x86_64.zip">https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.x86_64.zip</a>
+      <a href="https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_darwin.all.zip">https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_darwin.all.zip</a>
     </td>
   </tr>
   <tr>
-    <td>Windows arm64</td>
+    <td>Windows x86_64</td>
     <td>
-      <a href="https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.aarch64.zip">https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.aarch64.zip</a>
+      <a href="https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.x86_64.zip">https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.x86_64.zip</a>
     </td>
   </tr>
   <tr>
-    <td>macOS</td>
+    <td>Windows arm64</td>
     <td>
-      <a href="https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_darwin.all.zip">https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_darwin.all.zip</a>
+      <a href="https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.aarch64.zip">https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.aarch64.zip</a>
     </td>
   </tr>
 </table>
-
-## Installing Sauce Connect Proxy
-
-<Tabs
-defaultValue="Linux"
-  values={[
-    {label: 'Linux', value: 'Linux'},
-    {label: 'macOS', value: 'macOS'},
-    {label: 'Windows', value: 'Windows'},
-  ]}>
-<TabItem value="Linux">
-
-#### Binary
-
-```bash title="Download binary"
-mkdir $HOME/sauce-connect-5.0.0 && cd $HOME/sauce-connect-5.0.0
-curl -sLO https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_linux.x86_64.tar.gz
-tar xzf sauce-connect-5.0.0_linux.x86_64.tar.gz && rm sauce-connect-5.0.0_linux.x86_64.tar.gz
-```
-
-<details><summary>What's in the folder?</summary>
-
-#### Sauce Connect folder contents
-
-```bash
-  ├── LICENSE
-  ├── LICENSE.3RD_PARTY
-  ├── completions
-  │   ├── sc.bash
-  │   ├── sc.fish
-  │   └── sc.zsh
-  └── sc
-```
-
-</details>
-
-#### Debian
-```bash title="Install a Debian package"
-arch=$(dpkg --print-architecture)
-sc_version=5.0.0
-curl -sLO https://saucelabs.com/downloads/sauce-connect/${sc_version}/sauce-connect_${sc_version}.linux_${arch}.deb
-sudo dpkg --skip-same-version --install sauce-connect_${sc_version}.linux_${arch}.deb
-rm sauce-connect_${sc_version}.linux_${arch}.deb
-```
-
-<details><summary>What does the Sauce Connect Debian package install</summary>
-
-- Sauce Connect Proxy binary is in `/usr/bin/sc`
-- The enviroment variables file template is in `/etc/default/sauce-connect`. The file may be modified to include your configuration, , see [Running systemd service on Debian-based Linux](/secure-connections/sauce-connect-5/operation/systemd/)
-  ```bash
-  cat /etc/default/sauce-connect
-  # Default values for Sauce Connect Proxy
-  #SAUCE_CONFIG_FILE=/etc/sauce-connect/config.yaml
-  # Required values
-  #SAUCE_USERNAME=
-  #SAUCE_ACCESS_KEY=
-  #SAUCE_REGION=
-  #SAUCE_TUNNEL_NAME=
-  # Options
-  #SAUCE_SHARED=all
-  #SAUCE_TUNNEL_POOL=
-  # See https://docs.saucelabs.com/dev/cli/sauce-connect-5/ for all environment variable values
-  ```
-- Systemd service is enabled, see [Running systemd service on Debian-based Linux](/secure-connections/sauce-connect-5/operation/systemd/)
-
-</details>
-
-#### RPM
-
-```bash title="Install an RPM package"
-sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_linux.x86_64.rpm
-```
-
-  </TabItem>
-
-  <TabItem value="macOS">
-
-#### Homebrew
-
-```bash title="Homebrew (recommended)"
-brew install saucelabs/tap/sauce-connect
-```
-
-#### Binary
-
-```bash title="Download binary"
-mkdir $HOME/sauce-connect-5.0.0 && cd $HOME/sauce-connect-5.0.0
-curl -sLO "https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_darwin.all.zip"
-unzip sauce-connect-5.0.0_darwin.all.zip && rm sauce-connect-5.0.0_darwin.all.zip
-```
-
-<details><summary>What's in the folder?</summary>
-
-#### Sauce Connect folder contents
-
-```bash
-  ├── LICENSE
-  ├── LICENSE.3RD_PARTY
-  ├── completions
-  │   ├── sc.bash
-  │   ├── sc.fish
-  │   └── sc.zsh
-  └── sc
-```
-
-</details>
-
-  </TabItem>
-
-  <TabItem value="Windows">
-
-```bash title="Using Powershell (Windows)"
-Invoke-RestMethod -Uri https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_windows.x86_64.zip -OutFile sauce-connect-5.0.0.zip
-Expand-Archive -Force -Path ./sauce-connect-5.0.0.zip
-```
-
-  </TabItem>
-</Tabs>
-
-## Running Sauce Connect in Docker
-
-See [this guide](/secure-connections/sauce-connect-5/operation/docker/)
-
-## Running Sauce Connect in Kubernetes
-
-See [this guide](/secure-connections/sauce-connect-5/operation/kubernetes/)
-
-## More Information
-
-- [Sauce Connect Proxy Changelog](https://changelog.saucelabs.com/en?category=sauce%20connect)
-- [Sauce Connect Proxy 5 Administration](/secure-connections/sauce-connect-5/operation/overview/)
-- [Sauce Connect Proxy 5 CLI Reference](/dev/cli/sauce-connect-5/)
-- [Sauce Connect Proxy Architecture](/secure-connections/sauce-connect-5/advanced/architecture/)

docs/secure-connections/sauce-connect-5/operation/docker.md docs/secure-connections/sauce-connect-5/installation/docker.md

@@ -0,0 +1,186 @@
+---
+id: linux
+title: Install Sauce Connect on Linux
+sidebar_label: Linux
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+## Debian/Ubuntu
+
+Sauce Connect provides `.deb` package with Systemd service for [Sauce Connect run](/dev/cli/sauce-connect-5/run.md) command. 
+Other commands are available as well, but you will need to start them manually.
+
+### Install package
+
+<Tabs
+defaultValue="ARM64"
+  values={[
+    {label: 'ARM64', value: 'ARM64'},
+    {label: 'x86-64', value: 'x86-64'},
+  ]}>
+    <TabItem value="ARM64">
+
+```bash
+curl -L -o sauce-connect.deb https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect_5.0.0.linux_arm64.deb
+sudo dpkg -i sauce-connect.deb
+```
+  </TabItem>
+
+  <TabItem value="x86-64">
+
+```bash
+curl -L -o sauce-connect.deb https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect_5.0.0.linux_amd64.deb
+sudo dpkg -i sauce-connect.deb
+```
+
+  </TabItem>
+</Tabs>
+
+### Edit config file 
+
+```bash
+sudo vim /etc/sauce-connect/sauce-connect.yaml
+```
+
+### Enable and start Sauce Connect service
+
+```bash
+sudo systemctl enable sauce-connect
+sudo systemctl start sauce-connect
+```
+
+### Check Sauce Connect Status
+
+```bash
+sudo systemctl status sauce-connect
+```
+
+## RedHat/CentOS/Fedora
+
+Sauce Connect provides `.rpm` package with Systemd service for [Sauce Connect run](/dev/cli/sauce-connect-5/run.md) command.
+Other commands are available as well, but you will need to start them manually.
+
+
+### Install package
+
+<Tabs
+defaultValue="ARM64"
+  values={[
+    {label: 'ARM64', value: 'ARM64'},
+    {label: 'x86-64', value: 'x86-64'},
+  ]}>
+<TabItem value="ARM64">
+
+```bash
+sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_linux.aarch64.rpm
+```
+  </TabItem>
+
+  <TabItem value="x86-64">
+
+```bash
+sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_linux.x86_64.rpm
+```
+
+  </TabItem>
+</Tabs>
+
+### Edit config file
+
+```bash
+sudo vim /etc/sauce-connect/sauce-connect.yaml
+```
+
+### Enable and start Sauce Connect service
+
+```bash
+sudo systemctl enable sauce-connect
+sudo systemctl start sauce-connect
+```
+
+### Check Sauce Connect Status
+
+```bash
+sudo systemctl status sauce-connect
+```
+
+## Generic
+
+### Unpack the tarball
+
+<Tabs
+defaultValue="ARM64"
+  values={[
+    {label: 'ARM64', value: 'ARM64'},
+    {label: 'x86-64', value: 'x86-64'},
+  ]}>
+<TabItem value="ARM64">
+
+```bash
+curl -L -o sauce-connect.tar.gz https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_linux.aarch64.tar.gz
+sudo mkdir -p /opt/sauce-connect
+sudo tar -C /opt/sauce-connect -xzf sauce-connect.tar.gz
+```
+  </TabItem>
+
+  <TabItem value="x86-64">
+
+```bash
+curl -L -o sauce-connect.tar.gz https://saucelabs.com/downloads/sauce-connect/5.0.0/sauce-connect-5.0.0_linux.x86_64.tar.gz
+sudo mkdir -p /opt/sauce-connect
+sudo tar -C /opt/sauce-connect -xzf sauce-connect.tar.gz
+```
+
+  </TabItem>
+</Tabs>
+
+
+### Link the binary
+
+```bash
+sudo ln -s /opt/sauce-connect/sc /usr/local/bin/sc
+```
+
+### Add bash completion 
+
+<Tabs
+defaultValue="User"
+  values={[
+    {label: 'User', value: 'User'},
+    {label: 'System', value: 'System'},
+  ]}>
+<TabItem value="User">
+
+```bash
+echo 'source <(sc completion bash)' >>~/.bash_profile
+```
+  </TabItem>
+
+  <TabItem value="System">
+
+```bash
+sudo mkdir -p /etc/bash_completion.d
+sudo ln -s /opt/sauce-connect/completions/sc.bash /etc/bash_completion.d/sc
+```
+
+  </TabItem>
+</Tabs>
+
+### Edit config file 
+
+This step is optional. You can use default configuration or configure Sauce Connect with flags or environment variables. 
+See [CLI reference](/dev/cli/sauce-connect-5/) for more details.
+
+
+```bash
+vim /opt/sauce-connect/sauce-connect.yaml
+```
+
+### Start Sauce Connect
+
+```bash
+sc run --config-file /opt/sauce-connect/sauce-connect.yaml
+```