@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/slack.md

@@ -0,0 +1,865 @@
+# Installing Slack
+
+## Overview
+
+Slack is a team communication and collaboration platform that provides messaging, file sharing, and integrations with thousands of productivity tools. It enables teams to communicate through channels, direct messages, and huddles (audio/video calls). Slack is widely used in software development, business operations, and remote work environments.
+
+**Important Platform Note**: Slack for Linux is officially in beta. The native desktop application is only available for x86_64 (64-bit) architectures. ARM-based systems (including Raspberry Pi) do not have official native support and require alternative approaches documented below.
+
+## Dependencies
+
+### macOS (Homebrew)
+- **Required:**
+  - Homebrew package manager - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or `dev install homebrew`
+- **Optional:** None
+- **Auto-installed:** None
+
+### Ubuntu (APT/Snap)
+- **Required:**
+  - Snap package manager - Pre-installed on Ubuntu 16.04+. For Debian, install via `sudo apt-get update && sudo apt-get install -y snapd`
+  - x86_64 architecture (verified automatically; ARM is not supported)
+- **Optional:** None
+- **Auto-installed:** None
+
+### Raspberry Pi OS (APT/Snap)
+- **Required:**
+  - Chromium web browser - Install via `sudo apt-get update && sudo apt-get install -y chromium-browser`
+  - Internet connectivity for web application access
+- **Optional:**
+  - Slacky unofficial client (experimental) - See documentation for installation from GitHub releases
+- **Auto-installed:** None
+- **Note:** Native Slack desktop application is not available for ARM architecture. Web application at https://app.slack.com is the recommended approach.
+
+### Amazon Linux (DNF/YUM)
+- **Required:**
+  - DNF (Amazon Linux 2023, RHEL 8+, Fedora) or YUM (Amazon Linux 2) package manager - Pre-installed on supported distributions
+  - `curl` and `ca-certificates` packages - Install via `sudo dnf install -y curl ca-certificates` (for GPG key import)
+  - x86_64 architecture (verified automatically; ARM is not supported)
+- **Optional:**
+  - Graphical desktop environment (X11 or Wayland) - Required for GUI functionality; headless servers should use web application at https://app.slack.com
+- **Auto-installed:** None
+
+### Windows (Chocolatey/winget)
+- **Required:**
+  - Chocolatey package manager - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
+  - Administrator privileges for installation
+- **Optional:** None
+- **Auto-installed:** None
+
+### Git Bash (Manual/Portable)
+- **Required:**
+  - Chocolatey package manager installed on Windows host - See Windows installation method above
+  - PowerShell access on Windows host
+  - Administrator privileges on Windows for installation
+- **Optional:** None
+- **Auto-installed:** None
+- **Note:** Slack is installed on the Windows host, not within Git Bash environment. Access via `start slack:` or `cmd //c "start slack:"`
+
+## Prerequisites
+
+Before installing Slack on any platform, ensure:
+
+1. **Internet connectivity** - Required to download Slack and use all messaging features
+2. **Administrative privileges** - Required for system-wide installation on most platforms
+3. **Slack account** - Required to sign in (create at slack.com or through your organization)
+4. **64-bit operating system** - Required for native desktop applications (except web browser access)
+
+## Platform-Specific Installation
+
+### macOS (Homebrew)
+
+#### Prerequisites
+
+- macOS 11 (Big Sur) or later
+- Homebrew package manager installed
+- At least 500 MB free disk space
+- Apple Silicon (M1/M2/M3/M4) or Intel processor
+
+If Homebrew is not installed, install it first:
+
+```bash
+NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+#### Installation Steps
+
+Run the following command to install Slack:
+
+```bash
+brew install --quiet --cask slack
+```
+
+The `--quiet` flag suppresses non-essential output for automation-friendly installation. The `--cask` flag specifies the graphical application version.
+
+After installation, launch Slack from the Applications folder or via command line:
+
+```bash
+open -a Slack
+```
+
+**Note**: On first launch, Slack will prompt you to sign in with your workspace URL or email address.
+
+#### Verification
+
+Confirm the installation succeeded by checking if the application exists:
+
+```bash
+ls /Applications/ | grep -i slack
+```
+
+Expected output:
+
+```
+Slack.app
+```
+
+Verify Slack can launch:
+
+```bash
+open -a Slack
+```
+
+#### Troubleshooting
+
+**Problem**: `Error: Cask 'slack' requires macOS >= 11`
+
+**Solution**: Your macOS version is too old. Slack requires macOS 11 (Big Sur) or later. Upgrade your operating system before installing.
+
+**Problem**: "Slack is damaged and can't be opened" error
+
+**Solution**: Clear the quarantine attribute:
+
+```bash
+xattr -cr "/Applications/Slack.app"
+```
+
+**Problem**: Cask already installed
+
+**Solution**: If you need to reinstall, first uninstall then reinstall:
+
+```bash
+brew uninstall --cask slack
+brew install --quiet --cask slack
+```
+
+**Problem**: Slack fails to start after macOS upgrade
+
+**Solution**: Reinstall Slack:
+
+```bash
+brew uninstall --cask slack
+brew install --quiet --cask slack
+```
+
+---
+
+### Ubuntu/Debian (Snap)
+
+#### Prerequisites
+
+- Ubuntu 16.04 LTS or later, or Debian 10 (Buster) or later (64-bit x86_64)
+- sudo privileges
+- Snap package manager (pre-installed on Ubuntu 16.04+)
+- At least 500 MB free disk space
+
+Snap is pre-installed on Ubuntu 16.04 and later. If snap is not installed (common on Debian):
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+sudo systemctl enable --now snapd.socket
+sudo ln -sf /var/lib/snapd/snap /snap
+```
+
+After installing snapd on Debian, log out and log back in (or reboot) for the snap command to become available in your PATH.
+
+#### Installation Steps
+
+Run the following command to install Slack via Snap:
+
+```bash
+sudo snap install slack --classic
+```
+
+The `--classic` flag grants Slack access to system resources outside the snap sandbox, which is required for features like file access and system tray integration.
+
+After installation, launch Slack:
+
+```bash
+slack &
+```
+
+The ampersand (`&`) runs Slack in the background, freeing your terminal.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+snap list slack
+```
+
+Expected output (version may vary):
+
+```
+Name   Version   Rev   Tracking       Publisher   Notes
+slack  4.46.99   158   latest/stable  slack       classic
+```
+
+Verify Slack launches correctly:
+
+```bash
+slack &
+```
+
+The Slack window should appear within a few seconds.
+
+#### Troubleshooting
+
+**Problem**: `error: snap "slack" is not available on stable for this architecture`
+
+**Solution**: This error occurs on 32-bit systems or ARM architecture. Slack's Snap package requires 64-bit x86_64 architecture. Check your architecture:
+
+```bash
+uname -m
+```
+
+If output is anything other than `x86_64`, you must use the web application at https://app.slack.com instead.
+
+**Problem**: "cannot communicate with server: Post ... dial unix /run/snapd.socket"
+
+**Solution**: The snap daemon is not running. Start it:
+
+```bash
+sudo systemctl start snapd
+sudo systemctl enable snapd
+```
+
+**Problem**: Slack fails to launch with GPU/rendering errors
+
+**Solution**: Disable GPU acceleration by launching with:
+
+```bash
+slack --disable-gpu &
+```
+
+**Problem**: Notifications not appearing
+
+**Solution**: Ensure notification permissions are granted in your desktop environment settings. On GNOME, check Settings > Notifications > Slack.
+
+---
+
+### Raspberry Pi OS (ARM)
+
+#### Platform Limitation
+
+**Slack does not provide native ARM packages.** The official Slack desktop application and Snap package are only available for x86_64 architecture. Raspberry Pi devices use ARM processors, which are not supported.
+
+#### Prerequisites
+
+- Raspberry Pi OS (64-bit or 32-bit)
+- Raspberry Pi 3 or later
+- sudo privileges
+- Web browser (Chromium recommended)
+
+#### Installation Steps
+
+**Use the Slack Web Application**
+
+The recommended approach for Raspberry Pi is to use Slack through the web browser:
+
+```bash
+# Ensure Chromium is installed
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y chromium-browser
+
+# Launch Slack web application
+chromium-browser --app=https://app.slack.com &
+```
+
+The `--app` flag launches Chromium in application mode, providing a cleaner, app-like experience without browser chrome.
+
+**Create a Desktop Shortcut**
+
+For easier access, create a desktop shortcut:
+
+```bash
+mkdir -p ~/.local/share/applications
+
+cat > ~/.local/share/applications/slack-web.desktop << 'EOF'
+[Desktop Entry]
+Name=Slack
+Comment=Team Communication via Web
+Exec=chromium-browser --app=https://app.slack.com
+Icon=web-browser
+Terminal=false
+Type=Application
+Categories=Network;InstantMessaging;
+EOF
+```
+
+**Alternative: Unofficial Slacky Client (Experimental)**
+
+An unofficial ARM64 client called Slacky is available for 64-bit Raspberry Pi OS. Note that this is not officially supported by Slack:
+
+```bash
+# Download the latest release (check GitHub for current version)
+wget -q https://github.com/andirsun/Slacky/releases/latest/download/slacky_arm64.deb -O /tmp/slacky.deb
+
+# Install the package
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/slacky.deb
+
+# Clean up
+rm /tmp/slacky.deb
+```
+
+**Note**: The Slacky project is community-maintained and may not have feature parity with official Slack clients.
+
+#### Verification
+
+For web application approach, verify Chromium can access Slack:
+
+```bash
+chromium-browser --app=https://app.slack.com &
+```
+
+The Slack web application should load and prompt for sign-in.
+
+For Slacky (if installed), verify the application is installed:
+
+```bash
+which slacky || dpkg -l | grep slacky
+```
+
+#### Troubleshooting
+
+**Problem**: Web application is slow or unresponsive
+
+**Solution**: Raspberry Pi has limited resources. For better performance:
+- Use a Raspberry Pi 4 or 5 with at least 4 GB RAM
+- Close other applications while using Slack
+- Disable hardware acceleration in Chromium if experiencing crashes
+
+**Problem**: Cannot receive notifications from web application
+
+**Solution**: Web notifications require browser permission. When Slack prompts for notification permission, click "Allow". Ensure your desktop environment supports web notifications.
+
+**Problem**: Slacky fails to install due to missing dependencies
+
+**Solution**: Install required dependencies:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 libatspi2.0-0 libsecret-1-0
+```
+
+---
+
+### Amazon Linux/RHEL (DNF/YUM)
+
+#### Prerequisites
+
+- Amazon Linux 2023, Amazon Linux 2, RHEL 8/9, or Fedora (64-bit x86_64)
+- sudo privileges
+- Graphical desktop environment (required for Slack GUI)
+- At least 500 MB free disk space
+
+**Important**: Amazon Linux EC2 instances typically run headless (no GUI). If you are running a headless server, use the Slack web application at https://app.slack.com or the Slack API for automation.
+
+#### Installation Steps
+
+**Step 1: Import the GPG key**
+
+```bash
+sudo rpm --import https://packagecloud.io/slacktechnologies/slack/gpgkey
+```
+
+**Step 2: Create the repository configuration**
+
+```bash
+sudo tee /etc/yum.repos.d/slack.repo > /dev/null << 'EOF'
+[slack]
+name=Slack
+baseurl=https://packagecloud.io/slacktechnologies/slack/fedora/21/x86_64
+enabled=1
+gpgcheck=1
+gpgkey=https://packagecloud.io/slacktechnologies/slack/gpgkey
+sslverify=1
+sslcacert=/etc/pki/tls/certs/ca-bundle.crt
+metadata_expire=300
+EOF
+```
+
+**Note**: Despite the `fedora/21` path, this repository contains current packages compatible with all modern Fedora, RHEL, and Amazon Linux versions.
+
+**Step 3: Install Slack**
+
+For Amazon Linux 2023, RHEL 8/9, and Fedora:
+
+```bash
+sudo dnf install -y slack
+```
+
+For Amazon Linux 2:
+
+```bash
+sudo yum install -y slack
+```
+
+After installation, launch Slack:
+
+```bash
+slack &
+```
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+rpm -qa | grep slack
+```
+
+Expected output (version may vary):
+
+```
+slack-4.47.69-0.1.el8.x86_64
+```
+
+Verify Slack can launch (requires graphical environment):
+
+```bash
+slack &
+```
+
+#### Troubleshooting
+
+**Problem**: GPG key import fails
+
+**Solution**: Ensure curl is installed and retry:
+
+```bash
+sudo dnf install -y curl ca-certificates
+sudo rpm --import https://packagecloud.io/slacktechnologies/slack/gpgkey
+```
+
+**Problem**: "No package slack available"
+
+**Solution**: Verify the repository file was created correctly:
+
+```bash
+cat /etc/yum.repos.d/slack.repo
+```
+
+If empty or malformed, recreate it using the commands in Step 2.
+
+**Problem**: Slack fails to launch with display errors
+
+**Solution**: Slack requires a graphical environment. For headless servers:
+- Use X11 forwarding with SSH: `ssh -X user@server` then run `slack`
+- Use VNC or RDP to connect to a desktop session
+- Use the Slack web application at https://app.slack.com
+
+**Problem**: Dependency conflicts during installation
+
+**Solution**: Update system packages first:
+
+```bash
+sudo dnf update -y
+sudo dnf install -y slack
+```
+
+---
+
+### Windows (Chocolatey/winget)
+
+#### Prerequisites
+
+- Windows 10 version 1903 or later, or Windows 11 (64-bit)
+- At least 500 MB free disk space
+- Administrator PowerShell or Command Prompt
+- Chocolatey package manager installed
+
+If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
+```
+
+#### Installation Steps
+
+Run the following command in an Administrator PowerShell or Command Prompt:
+
+```powershell
+choco install slack -y
+```
+
+The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation.
+
+After installation, Slack can be launched from the Start Menu or via command line:
+
+```powershell
+Start-Process slack:
+```
+
+**Note**: On first launch, Slack will prompt you to sign in with your workspace URL or email address.
+
+#### Verification
+
+Open a new Command Prompt or PowerShell window, then verify Slack is installed:
+
+```powershell
+choco list slack
+```
+
+Expected output (version may vary):
+
+```
+slack 4.47.69
+1 packages installed.
+```
+
+Launch Slack to verify it opens correctly:
+
+```powershell
+Start-Process slack:
+```
+
+The application should launch and display the sign-in screen.
+
+#### Troubleshooting
+
+**Problem**: `choco: command not found` or `'choco' is not recognized`
+
+**Solution**: Chocolatey is not installed or not in PATH. Install Chocolatey first (see Prerequisites), then open a new terminal window.
+
+**Problem**: Installation fails with permission errors
+
+**Solution**: Run PowerShell as Administrator. Right-click PowerShell in the Start Menu and select "Run as administrator".
+
+**Problem**: Slack fails to launch after installation
+
+**Solution**: Restart your computer to ensure all components are properly registered, then try launching again.
+
+**Problem**: Need to update Slack
+
+**Solution**: Run the upgrade command:
+
+```powershell
+choco upgrade slack -y
+```
+
+---
+
+### WSL (Ubuntu)
+
+#### Platform Approach
+
+**Slack is installed on the Windows host, not within WSL.** While WSL with WSLg (GUI support) can technically run Linux GUI applications, the recommended approach is to install Slack on Windows and access it from WSL.
+
+#### Prerequisites
+
+- Windows 10 version 2004 or higher, or Windows 11
+- WSL 2 enabled with Ubuntu distribution installed
+- Administrator access on Windows for Slack installation
+
+#### Installation Steps
+
+**Step 1: Install Slack on Windows**
+
+From a Windows Administrator PowerShell:
+
+```powershell
+choco install slack -y
+```
+
+**Step 2: Access Slack from WSL**
+
+From within your WSL terminal, you can launch Windows Slack:
+
+```bash
+# Launch Slack using Windows protocol handler
+cmd.exe /c start slack:
+```
+
+This command uses Windows interoperability to launch the Slack application installed on the Windows host.
+
+**Alternative: Access Slack via browser from WSL**
+
+If you prefer browser-based access:
+
+```bash
+# Open Slack web application in default Windows browser
+cmd.exe /c start https://app.slack.com
+```
+
+#### Verification
+
+From WSL, verify you can launch Windows Slack:
+
+```bash
+cmd.exe /c start slack:
+```
+
+Slack should open in a new window on the Windows desktop.
+
+#### Troubleshooting
+
+**Problem**: Cannot launch Windows Slack from WSL
+
+**Solution**: Ensure Slack is installed on Windows first. Run `choco list slack` in a Windows PowerShell to verify installation.
+
+**Problem**: "start: command not found"
+
+**Solution**: Use the full Windows command syntax:
+
+```bash
+cmd.exe /c start slack:
+```
+
+**Problem**: Need to use Slack commands in WSL scripts
+
+**Solution**: Create a helper alias in your `~/.bashrc`:
+
+```bash
+echo 'alias slack="cmd.exe /c start slack:"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+Then simply run `slack` from your WSL terminal.
+
+---
+
+### Git Bash (Windows Installation)
+
+#### Prerequisites
+
+- Windows 10 or Windows 11 (64-bit)
+- Git Bash installed (comes with Git for Windows)
+- Administrator access for Slack installation
+
+#### Installation Steps
+
+Git Bash runs on Windows, so Slack is installed on the Windows host and accessible from Git Bash.
+
+**Step 1: Install Slack on Windows**
+
+From an Administrator Command Prompt or PowerShell (not Git Bash):
+
+```powershell
+choco install slack -y
+```
+
+**Step 2: Access Slack from Git Bash**
+
+After installation, Slack can be launched from Git Bash:
+
+```bash
+start slack:
+```
+
+Or use the explicit command form:
+
+```bash
+cmd //c "start slack:"
+```
+
+#### Verification
+
+From Git Bash, verify Slack can be launched:
+
+```bash
+start slack:
+```
+
+Slack should open in a new window.
+
+#### Troubleshooting
+
+**Problem**: `start: command not found`
+
+**Solution**: Use the Windows-style command:
+
+```bash
+cmd //c "start slack:"
+```
+
+**Problem**: Slack does not launch
+
+**Solution**: Ensure Slack is installed on Windows. Open a Windows Command Prompt and verify:
+
+```cmd
+choco list slack
+```
+
+If not installed, install it from an Administrator PowerShell first.
+
+**Problem**: Need to use Slack in scripts
+
+**Solution**: For scripting, use the Windows command wrapper:
+
+```bash
+#!/bin/bash
+# Launch Slack silently
+cmd //c "start /min slack:" 2>/dev/null
+```
+
+---
+
+## Post-Installation Configuration
+
+After installing Slack on any platform, complete these configuration steps.
+
+### Signing In
+
+1. Launch Slack
+2. Enter your workspace URL (e.g., `yourcompany.slack.com`) or email address
+3. Follow the authentication prompts
+4. Complete any organization-specific setup (SSO, 2FA, etc.)
+
+### Configuring Notifications
+
+Adjust notification settings to manage interruptions:
+
+1. Click on your profile picture in Slack
+2. Go to **Preferences** > **Notifications**
+3. Configure notification preferences for messages, mentions, and keywords
+4. Set notification schedules for work hours
+
+### Setting Up Multiple Workspaces
+
+If you belong to multiple Slack workspaces:
+
+1. Click the workspace name in the top left
+2. Select **Add a workspace**
+3. Enter the workspace URL or sign in with your email
+4. Switch between workspaces using `Ctrl+[number]` (Windows/Linux) or `Cmd+[number]` (macOS)
+
+### Keyboard Shortcuts
+
+Essential shortcuts for productivity:
+
+| Action | Windows/Linux | macOS |
+|--------|---------------|-------|
+| Quick Switcher | `Ctrl+K` | `Cmd+K` |
+| Search | `Ctrl+G` | `Cmd+G` |
+| New Message | `Ctrl+N` | `Cmd+N` |
+| Mark All Read | `Shift+Esc` | `Shift+Esc` |
+| Toggle Sidebar | `Ctrl+Shift+D` | `Cmd+Shift+D` |
+
+### Configuring Startup Behavior
+
+To control whether Slack starts automatically:
+
+**Windows:**
+1. Open Slack Preferences
+2. Go to **Advanced**
+3. Toggle "Launch Slack on login" on or off
+
+**macOS:**
+1. Open Slack Preferences
+2. Go to **Advanced**
+3. Toggle "Launch Slack on login" on or off
+
+**Linux:**
+```bash
+# Disable autostart
+rm ~/.config/autostart/slack.desktop 2>/dev/null || true
+```
+
+---
+
+## Common Issues
+
+### Issue: "Unable to Connect" or Network Errors
+
+**Symptoms**: Slack shows connection errors or fails to load messages
+
+**Solutions**:
+- Check internet connectivity
+- Verify firewall allows Slack traffic (ports 443, 80)
+- If behind a corporate proxy, configure proxy settings in Slack Preferences > Advanced > Proxy
+- Try signing out and signing back in
+
+### Issue: High Memory or CPU Usage
+
+**Symptoms**: Slack consumes excessive system resources
+
+**Solutions**:
+- Close unused workspaces (each workspace uses additional memory)
+- Disable animations: Preferences > Accessibility > Reduce animations
+- Restart Slack periodically during long sessions
+- Ensure Slack is updated to the latest version
+
+### Issue: Notifications Not Working
+
+**Symptoms**: Missing notifications for messages or calls
+
+**Solutions**:
+
+**All Platforms:**
+- Check Slack notification settings in Preferences > Notifications
+- Ensure "Do Not Disturb" mode is not enabled
+- Verify notification schedule allows notifications at current time
+
+**macOS:**
+- Grant notification permission in System Preferences > Notifications > Slack
+
+**Linux:**
+- Ensure notification daemon is running
+- Check desktop environment notification settings
+
+**Windows:**
+- Check Windows notification settings: Settings > System > Notifications > Slack
+
+### Issue: Screen Sharing Not Working
+
+**Symptoms**: Screen sharing option is grayed out or not functioning
+
+**Solutions**:
+
+**macOS:** Grant screen recording permission in System Preferences > Security & Privacy > Privacy > Screen Recording
+
+**Linux:** On Wayland, screen sharing may have limitations. Consider using X11 session for full screen sharing support.
+
+**Windows:** Ensure Slack has necessary permissions. Run as administrator if sharing specific applications fails.
+
+### Issue: Audio/Video in Huddles Not Working
+
+**Symptoms**: Cannot hear or be heard in Slack Huddles
+
+**Solutions**:
+- Check audio device settings in Slack Preferences > Audio & Video
+- Ensure correct microphone and speaker are selected
+- Grant microphone permission if prompted by operating system
+- Close other applications that might be using audio devices
+- Test audio with Slack's built-in audio test
+
+---
+
+## Summary Table
+
+| Platform | Native Support | Installation Method | Notes |
+|----------|---------------|---------------------|-------|
+| macOS | Yes | `brew install --quiet --cask slack` | Requires macOS 11+ |
+| Windows | Yes | `choco install slack -y` | Primary supported platform |
+| Ubuntu/Debian | Yes (Beta) | `sudo snap install slack --classic` | x86_64 only |
+| Raspberry Pi | No | Web app via Chromium | Use https://app.slack.com |
+| Amazon Linux/RHEL | Yes (Beta) | DNF repository + `sudo dnf install -y slack` | x86_64 only |
+| WSL | N/A | Install on Windows host | Uses Windows installation |
+| Git Bash | N/A | Uses Windows installation | Inherits Windows Slack |
+
+---
+
+## References
+
+- [Slack Official Website](https://slack.com/)
+- [Slack Downloads](https://slack.com/downloads)
+- [Slack for Linux (Beta)](https://slack.com/help/articles/212924728-Download-Slack-for-Linux--beta-)
+- [Slack Homebrew Cask](https://formulae.brew.sh/cask/slack)
+- [Slack Chocolatey Package](https://community.chocolatey.org/packages/slack)
+- [Slack Snap Package](https://snapcraft.io/slack)
+- [Slack Web Application](https://app.slack.com)
+- [Slack Release Notes - Linux](https://slack.com/release-notes/linux)
+- [Slacky - Unofficial ARM64 Client](https://github.com/andirsun/Slacky)
+- [Slack API Documentation](https://api.slack.com/)