RocketChat
diff --git a/‎.github/workflows/pull-request-build.yml‎
Lines changed: 4 additions & 5 deletions b/‎.github/workflows/pull-request-build.yml‎
Lines changed: 4 additions & 5 deletions
diff --git a/‎docs/linux-display-server.md‎
Lines changed: 136 additions & 0 deletions b/‎docs/linux-display-server.md‎
Lines changed: 136 additions & 0 deletions
diff --git a/‎electron-builder.json‎
Lines changed: 13 additions & 4 deletions b/‎electron-builder.json‎
Lines changed: 13 additions & 4 deletions
diff --git a/‎package.json‎
Lines changed: 1 addition & 1 deletion b/‎package.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎rollup.config.mjs‎
Lines changed: 8 additions & 1 deletion b/‎rollup.config.mjs‎
Lines changed: 8 additions & 1 deletion
diff --git a/‎scripts/README.md‎
Lines changed: 139 additions & 0 deletions b/‎scripts/README.md‎
Lines changed: 139 additions & 0 deletions
@@ -522,7 +522,7 @@ jobs:
 
       - name: Build Ubuntu Package
         if: ${{ matrix.build-target == 'linux' }}
-        run: yarn electron-builder --publish never --linux snap deb
+        run: yarn electron-builder --publish never --linux snap deb appimage
 
       - name: Find Snap File
         id: find_snap
@@ -586,6 +586,7 @@ jobs:
             --endpoint-url=https://s3.us-east-1.wasabisys.com \
             --exclude "*" \
             --include "rocketchat-*.snap" \
+            --include "rocketchat-*.AppImage" \
             --include "rocketchat-*.deb"
         env:
           AWS_ACCESS_KEY_ID: ${{ secrets.WASABI_ACCESS_KEY_ID }}
@@ -601,7 +602,7 @@ jobs:
             const path = require('path');
             const distDir = path.join(process.cwd(), 'dist');
             const files = fs.readdirSync(distDir);
-            const patterns = [/rocketchat-.*\.dmg$/, /rocketchat-.*\.pkg$/, /rocketchat-.*\.exe$/, /rocketchat-.*\.snap$/, /rocketchat-.*\.deb$/];
+            const patterns = [/rocketchat-.*\.dmg$/, /rocketchat-.*\.pkg$/, /rocketchat-.*\.exe$/, /rocketchat-.*\.snap$/, /rocketchat-.*\.deb$/, /rocketchat-.*\.appimage$/i];
             let artifactUrls = '';
             for (const file of files) {
               if (patterns.some(pattern => pattern.test(file))) {
@@ -616,9 +617,7 @@ jobs:
         uses: marocchino/sticky-pull-request-comment@v2
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          header: ${{ runner.os }}-installer
           message: |
             ### ${{ runner.os }} installer download
             ${{ steps.get-artifact-urls.outputs.artifact_urls }}
-          header: '### ${{ runner.os }} installer download'
-          recreate: true
-          append: false
@@ -0,0 +1,136 @@
+# Linux Display Server Configuration
+
+Rocket.Chat Desktop uses native Wayland by default when available, with automatic GPU crash recovery.
+
+## Default Behavior
+
+| Package Type | Display Server | Notes |
+|--------------|---------------|-------|
+| **deb/rpm** | Native (Wayland/X11) | Uses system default |
+| **Snap** | Native (Wayland/X11) | Uses system default |
+| **AppImage** | Native (Wayland/X11) | Uses system default |
+
+## Automatic GPU Crash Recovery
+
+Rocket.Chat Desktop includes automatic GPU crash detection and recovery:
+
+1. **Crash Detection**: If the GPU process crashes during startup (e.g., due to incompatible drivers), the app detects this automatically.
+
+2. **Automatic Fallback**: After detecting repeated crashes, the app relaunches with GPU acceleration disabled.
+
+3. **Recovery**: Once GPU is disabled, the app will continue to run with software rendering.
+
+## Wayland Support
+
+Rocket.Chat Desktop includes native Wayland support with:
+- PipeWire screen capture for video calls
+- Native OS screen picker integration
+- Hardware acceleration
+
+### Requirements for Wayland
+- `xdg-desktop-portal` (recommended, auto-suggested by deb/rpm packages)
+- `xdg-desktop-portal-gtk` or desktop-specific portal backend
+- PipeWire for screen sharing
+- Modern GPU drivers
+
+## Known Issues
+
+### Virtual Machines
+VMs with paravirtual graphics (QXL, VirtualBox, VMware) may have issues with GPU acceleration.
+
+**Symptoms:**
+```text
+ERROR:viz_main_impl.cc:189] Exiting GPU process due to errors during initialization
+```
+
+**Automatic Recovery:** The app automatically detects this crash and disables GPU acceleration. You should see the app restart and work normally after the crashes.
+
+**Manual Solution:** If auto-recovery doesn't work, disable GPU:
+```bash
+rocketchat-desktop --disable-gpu
+```
+
+### Screen Sharing Not Working on Wayland
+
+If screen sharing doesn't work on Wayland:
+
+1. Install portal dependencies:
+```bash
+# Ubuntu/Debian
+sudo apt install xdg-desktop-portal xdg-desktop-portal-gtk pipewire
+
+# Fedora
+sudo dnf install xdg-desktop-portal xdg-desktop-portal-gtk pipewire
+
+# Arch
+sudo pacman -S xdg-desktop-portal xdg-desktop-portal-gtk pipewire
+```
+
+2. Restart your session or reboot
+
+3. Verify PipeWire is running:
+```bash
+systemctl --user status pipewire
+```
+
+## Manual Override
+
+You can force a specific display server:
+
+```bash
+# Force X11
+rocketchat-desktop --ozone-platform=x11
+
+# Force Wayland
+rocketchat-desktop --ozone-platform=wayland
+
+# Disable GPU acceleration
+rocketchat-desktop --disable-gpu
+```
+
+## Troubleshooting
+
+### Check Your Display Server
+```bash
+echo $XDG_SESSION_TYPE
+# Output: "wayland" or "x11"
+```
+
+### Check GPU Support
+```bash
+# Check graphics card
+lspci | grep -i vga
+
+# Check VA-API support (hardware video decode)
+vainfo
+```
+
+### Enable Verbose Logging
+
+These are standard Chromium flags that enable detailed logging output:
+
+```bash
+rocketchat-desktop --enable-logging --v=1
+```
+
+### Disable GPU Acceleration (last resort)
+```bash
+rocketchat-desktop --disable-gpu
+```
+
+## Best Practices
+
+- **Real Hardware + Wayland**: Use default for best experience
+- **VM**: The app will auto-detect and disable GPU after crashes
+- **X11 Session**: Works automatically
+- **Snap Package**: Uses native display server
+
+## Reporting Issues
+
+When reporting display server issues, include:
+
+1. Display server type: `echo $XDG_SESSION_TYPE`
+2. Graphics card: `lspci | grep -i vga`
+3. Distribution: `cat /etc/os-release`
+4. Package type: snap/deb/rpm/AppImage
+5. Full error output with `--enable-logging --v=1`
@@ -133,17 +133,26 @@
   "deb": {
     "fpm": [
       "--after-install=build/linux/postinst.sh"
+    ],
+    "recommends": [
+      "xdg-desktop-portal",
+      "xdg-desktop-portal-gtk"
     ]
   },
   "rpm": {
-    "fpm": ["--rpm-rpmbuild-define=_build_id_links none"]
+    "fpm": [
+      "--rpm-rpmbuild-define=_build_id_links none",
+      "--rpm-tag=Recommends: xdg-desktop-portal",
+      "--rpm-tag=Recommends: xdg-desktop-portal-gtk"
+    ]
   },
   "snap": {
     "plugs": [
       "desktop",
       "desktop-legacy",
       "home",
       "x11",
+      "wayland",
       "unity7",
       "browser-support",
       "network",
@@ -154,9 +163,9 @@
       "audio-playback",
       "audio-record",
       "screen-inhibit-control",
-      "upower-observe"
-    ],
-    "executableArgs": ["--ozone-platform=x11"]
+      "upower-observe",
+      "pipewire"
+    ]
   },
   "afterSign": "./build/notarize.js",
   "generateUpdatesFilesForAllChannels": true,
 
@@ -6,7 +6,7 @@
   "productName": "Rocket.Chat",
   "name": "rocketchat",
   "description": "Official OSX, Windows, and Linux Desktop Clients for Rocket.Chat",
-  "version": "4.10.1",
+  "version": "4.10.2",
   "author": "Rocket.Chat Support <support@rocket.chat>",
   "copyright": "© 2016-2025, Rocket.Chat",
   "homepage": "https://rocket.chat",
 
@@ -34,7 +34,14 @@ const run = () => {
         proc ? 'Restarting main process...' : 'Starting main process...'
       );
 
-      proc = spawn(electron, ['.'], { stdio: 'inherit' });
+      const electronArgs = ['.'];
+
+      // Linux-specific flags for development
+      if (process.platform === 'linux') {
+        electronArgs.push('--no-sandbox');
+      }
+
+      proc = spawn(electron, electronArgs, { stdio: 'inherit' });
 
       proc.on('close', () => {
         proc = null;
 
@@ -0,0 +1,139 @@
+# Testing Scripts
+
+This directory contains automation scripts for testing Rocket.Chat Desktop on Linux.
+
+## Scripts
+
+### `install-volta.sh`
+
+Installs Volta (JavaScript toolchain manager) if it's not already installed. Volta provides node.js and npm, which are required for building the project.
+
+#### Usage
+
+```bash
+# Interactive mode (prompts before installing)
+./scripts/install-volta.sh
+
+# Non-interactive mode (installs automatically)
+./scripts/install-volta.sh --non-interactive
+```
+
+#### What It Does
+
+1. **Checks if Volta is installed**
+   - Looks for `volta` command in PATH
+   - Checks `$VOLTA_HOME` environment variable
+   - Checks common installation location (`~/.volta/bin/volta`)
+
+2. **Installs Volta if missing**
+   - Downloads and runs the official Volta installer
+   - Adds Volta to PATH for current session
+   - Adds Volta to `~/.bashrc` for future sessions
+
+3. **Verifies installation**
+   - Checks that `volta` command is available
+   - Displays Volta version
+
+#### Features
+
+- Can be sourced by other scripts to use its functions
+- Non-interactive mode for CI/automation
+- Automatically adds Volta to shell profile
+- Safe to run multiple times (skips if already installed)
+
+#### Requirements
+
+- `curl` (for downloading Volta installer)
+- Internet connection
+
+### `linux-test-deb.sh`
+
+Builds, installs, and runs the Rocket.Chat Desktop .deb package for testing purposes.
+
+#### Usage
+
+```bash
+./scripts/linux-test-deb.sh [OPTIONS]
+```
+
+#### Options
+
+- `--skip-build` - Skip building the .deb package (useful if you've already built it)
+- `--skip-install` - Skip installing the .deb package (useful for testing installation separately)
+- `--skip-run` - Skip running the installed app (useful if you just want to install)
+- `--help`, `-h` - Show help message
+
+#### Examples
+
+Build, install, and run:
+```bash
+./scripts/linux-test-deb.sh
+```
+
+Skip build if .deb already exists:
+```bash
+./scripts/linux-test-deb.sh --skip-build
+```
+
+Only build and install, don't run:
+```bash
+./scripts/linux-test-deb.sh --skip-run
+```
+
+#### What It Does
+
+1. **Builds the .deb package**
+   - Runs `yarn build-linux` to build the app and create Linux packages
+   - Outputs to `dist/` directory
+
+2. **Finds the .deb file**
+   - Searches for `dist/rocketchat-*-linux-*.deb`
+   - Uses the first matching file found
+
+3. **Installs the .deb package**
+   - Uninstalls any previous version if present
+   - Installs the new package using `dpkg -i`
+   - Automatically fixes missing dependencies with `apt-get install -f`
+
+4. **Runs the installed app**
+   - Launches Rocket.Chat Desktop from `/opt/Rocket.Chat/rocketchat-desktop`
+   - Runs in background and displays the process ID
+
+#### Requirements
+
+- Linux operating system
+- `node.js` and `yarn` (or Volta - the script will install it automatically if needed)
+- `dpkg` and `apt-get` (standard on Debian/Ubuntu systems)
+- `curl` (for installing Volta if needed)
+- Sudo access (for installation, if not running as root)
+
+#### Automatic Dependency Installation
+
+The script automatically installs missing dependencies:
+- **Volta** (if node.js/yarn not found) - provides node.js and npm
+- **binutils** (if `ar` command not found) - required for building .deb packages
+- **Package dependencies** - automatically resolved during .deb installation
+
+#### Output
+
+The script provides color-coded output:
+- 🔵 Blue: Informational messages
+- 🟢 Green: Success messages
+- 🟡 Yellow: Warnings
+- 🔴 Red: Errors
+
+#### Error Handling
+
+The script will exit with a non-zero status code if any step fails. Common issues:
+
+- **Build fails**: Check that all dependencies are installed (`yarn install`)
+- **Install fails**: Ensure you have sudo access and the .deb file is valid
+- **App not found**: The installation path may differ; check `/opt/Rocket.Chat/` or use `which rocketchat-desktop`
+
+#### Notes
+
+- The script automatically handles uninstalling previous versions
+- Missing dependencies are automatically resolved during installation
+- The app runs in the background; use `kill <PID>` to stop it
+- This script is intended for development/testing purposes only
+