Improve README and OS prerequisites documentation

Co-authored-by: salmanmkc <32169182+salmanmkc@users.noreply.github.com>

docs/start/envlinux.md

@@ -6,10 +6,21 @@
 
 Please see "[Supported architectures and operating systems for self-hosted runners](https://docs.github.com/en/actions/reference/runners/self-hosted-runners#linux)."
 
-## Install .Net Core 3.x Linux Dependencies
+## Quick Setup
+
+The `./config.sh` script will automatically check and guide you through installing .NET dependencies:
+
+```bash
+./config.sh
+# If dependencies are missing, run:
+./bin/installdependencies.sh
+```
+
+## Install .NET Core Linux Dependencies
+
+The `./config.sh` will check .NET Core dependencies during runner configuration.  
+You might see something like this which indicates a dependency is missing:
 
-The `./config.sh` will check .Net Core 3.x dependencies during runner configuration.  
-You might see something like this which indicate a dependency's missing.
 ```bash
 ./config.sh
     libunwind.so.8 => not found
@@ -17,34 +28,87 @@ You might see something like this which indicate a dependency's missing.
 Dependencies is missing for Dotnet Core 6.0
 Execute ./bin/installdependencies.sh to install any missing Dotnet Core 6.0 dependencies.
 ```
+
 You can easily correct the problem by executing `./bin/installdependencies.sh`.  
 The `installdependencies.sh` script should install all required dependencies on all supported Linux versions  
-> Note: The `installdependencies.sh` script will try to use the default package management mechanism on your Linux flavor (ex. `yum`/`apt-get`/`apt`).
 
-### Full dependencies list
+> **Note:** The `installdependencies.sh` script will try to use the default package management mechanism on your Linux flavor (ex. `yum`/`apt-get`/`apt`).
 
-Debian based OS (Debian, Ubuntu, Linux Mint)
+## Manual Dependency Installation
 
+If the automatic installation doesn't work, you can manually install dependencies using your package manager:
+
+### Debian based OS (Debian, Ubuntu, Linux Mint)
+
+```bash
+sudo apt-get update
+sudo apt-get install -y liblttng-ust1 libkrb5-3 zlib1g libssl1.1 libicu66
+```
+
+**Required packages:**
 - liblttng-ust1 or liblttng-ust0
 - libkrb5-3
 - zlib1g
 - libssl1.1, libssl1.0.2 or libssl1.0.0
 - libicu63, libicu60, libicu57 or libicu55
 
-Fedora based OS (Fedora, Red Hat Enterprise Linux, CentOS, Oracle Linux 7)
+### Fedora based OS (Fedora, Red Hat Enterprise Linux, CentOS, Oracle Linux 7)
 
+```bash
+sudo yum install -y lttng-ust openssl-libs krb5-libs zlib libicu
+# Or for newer systems:
+sudo dnf install -y lttng-ust openssl-libs krb5-libs zlib libicu
+```
+
+**Required packages:**
 - lttng-ust
 - openssl-libs
 - krb5-libs
 - zlib
 - libicu
 
-SUSE based OS (OpenSUSE, SUSE Enterprise)
+### SUSE based OS (OpenSUSE, SUSE Enterprise)
 
+```bash
+sudo zypper install -y lttng-ust libopenssl1_1 krb5 zlib libicu60_2
+```
+
+**Required packages:**
 - lttng-ust
 - libopenssl1_1
 - krb5
 - zlib
 - libicu60_2
 
-## [More .Net Core Prerequisites Information](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x)
+## Troubleshooting
+
+### Common Issues
+
+**Permission denied errors:**
+```bash
+sudo chmod +x ./config.sh ./run.sh
+```
+
+**Missing dependencies after installation:**
+```bash
+# Check what's missing
+ldd ./bin/Runner.Listener
+# Reinstall dependencies
+./bin/installdependencies.sh
+```
+
+**SSL/TLS errors:**
+```bash
+# Update certificates
+sudo apt-get update && sudo apt-get install ca-certificates
+# Or for RHEL/CentOS:
+sudo yum update ca-certificates
+```
+
+### Getting Help
+
+- Check our [troubleshooting guide](../checks/README.md)
+- Search [GitHub Community Discussions](https://github.com/orgs/community/discussions/categories/actions)
+- Review [common network issues](../checks/network.md)
+
+## [More .NET Core Prerequisites Information](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x)