Update Installation instructions for Transactional/Atomic distributions

scripts/install-transactional-systemds.md

@@ -0,0 +1,55 @@
+# Installing in Transactional systems
+
+Transactional systems (also Atomic, Immutable) are a Linux variant where direct modification of the root file system isn't permitted even for the root user. Some examples of transactional systems are [SLE Micro](https://www.suse.com/products/micro/), [openSUSE Leap Micro](https://get.opensuse.org/leapmicro/6.2/), [openSUSE MicroOS](https://get.opensuse.org/microos/), [Fedora Silverblue](https://www.fedoraproject.org/atomic-desktops/silverblue/), [Fedora CoreOS](https://www.fedoraproject.org/coreos/)
+The installation of `opkssh` in these machines needs slight adjustments and this document details the changes necessary for installation on those systems.
+
+## openSUSE Leap Micro 6.2
+
+NOTE: This should also work the same for MicroOS and SLE Micro too.
+
+- Enter shell
+
+  ```bash
+  sudo transactional-update shell
+  ```
+- Create necessary folders and data
+
+  ```bash
+  mkdir /opt/opkssh
+  cd /tmp
+  curl -LO https://raw.githubusercontent.com/openpubkey/opkssh/main/scripts/install-linux.sh
+  chmod u+x install-linux.sh
+  ```
+- Setup necessary variables and install, we select `/opt` since this isn't part of the snapshots and also considered as the locations for user installations. Using `/usr/` won't work since it's read only.
+
+  ```bash
+  export OPKSSH_INSTALL_DIR=/opt/opkssh
+  ./install-linux.sh --no-home-policy
+  ```
+- Output should be similar to follows
+
+    ```bash
+    Bash version: 5.2
+    Added opksshuser to group: opksshuser
+    Downloading version latest of opkssh from https://github.com/openpubkey/opkssh/releases/latest/download/opkssh-linux-amd64...
+    opkssh                          100%[=====================================================>]  12.74M  11.0MB/s    in 1.2s
+    Installed opkssh to /opt/opkssh/opkssh
+    SELinux detected. Configuring SELinux for opkssh
+      Restoring context for /opt/opkssh/opkssh...
+      Downloading TE-file
+      Compiling SELinux module...
+      Packaging module...
+      Installing module...
+    SELinux module installed successfully!
+    Configuring opkssh:
+    Running in chroot, ignoring command 'restart'
+    Installation successful! Run 'opkssh' to use it.
+    ```
+  - Exit the shell and reboot
+
+    ```bash
+    exit
+    sudo shutdown -r now
+    ```
+
+- After restart, setup the policies and providers as required. NOTE: For all the scripts use the absolute path of the installation `/opt/opkssh/opkssh`

scripts/installing.md

@@ -33,19 +33,9 @@ This is useful if you want to install a locally built opkssh binary.
 
 ## What the script is doing
 
-**1: Build opkssh.** Run the following from the root directory, replace GOARCH and GOOS to match with server you wish to install OPKSSH. This will generate the opkssh binary.
+**1: Download opkssh.** Download opkssh binary from Github releases for the corresponding OS and CPU architecture.
 
-```bash
-go build
-```
-
-**2: Copy opkssh to server.** Copy the opkssh binary you just built in the previous step to the SSH server you want to configure
-
-```bash
-scp opkssh ${USER}@${HOSTNAME}:~
-```
-
-**3: Install opkssh on server.** SSH to the server
+**2: Move binary to install directory.** SSH to the server
 
 Create the following file directory structure on the server and move the executable there: