> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

### Installation Dependency Issues

If dependency issues occur when installing the deb package, run the following command to fix them:

```bash theme={null}
sudo apt-get install -f
```

### Serial Port Permission Issues

If the software reports insufficient serial port permissions, use one of the following methods:

```bash theme={null}
sudo wujihand-upgrader
```

Or add your user to the `dialout` group (recommended, no sudo needed each time):

```bash theme={null}
sudo usermod -a -G dialout $USER
newgrp dialout
wujihand-upgrader
```

### Upgrader Window Not Displaying

If clicking the desktop icon shows the upgrader icon in the taskbar but the main window never appears, start the upgrader from a terminal for troubleshooting.

If the terminal shows `Failed to create GBM buffer of size 1280x720: Permission denied` (GBM buffer error), it usually means the NVIDIA driver does not have DRM Kernel Mode Setting enabled. For background information, see [dioxus#1909](https://github.com/DioxusLabs/dioxus/issues/1909#issuecomment-1974930010).

To resolve this issue:

1. Check if modesetting is enabled:

   ```bash theme={null}
   cat /sys/module/nvidia_drm/parameters/modeset
   ```

2. If the output is `N`, enable it with the following command:

   ```bash theme={null}
   echo options nvidia_drm modeset=1 | sudo tee /etc/modprobe.d/nvidia_drm.conf
   ```

3. Restart the computer, then launch the upgrader again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.