wsa-webdav/docs/troubleshooting.md

# Troubleshooting

Common issues and solutions for WSA WebDev.

## Build Issues

### Java not found

**Error:** `JAVA_HOME is not set`

**Solution:**
1. Install JDK 17
2. Set JAVA_HOME environment variable
3. Or let the build script auto-install via winget/choco

### Gradle build fails

**Error:** `Could not resolve dependencies`

**Solution:**
1. Delete `.build/` directory
2. Run build script again
3. Check internet connection

### APK not installing

**Error:** `INSTALL_FAILED_ALREADY_EXISTS`

**Solution:**
```bash
adb uninstall com.wsa.webdav
adb install output/app-release.apk
```

## Server Issues

### Server won't start

1. Check if port 8088 is in use:
   ```bash
   netstat -ano | findstr 8088
   ```
2. Kill the process using the port
3. Restart the server

### Connection refused

1. Ensure WSA is running
2. Check ADB connection: `adb devices`
3. Verify server is running:
   ```bash
   adb shell pidof com.wsa.webdav
   ```

### Slow performance

1. Use USB instead of WiFi for ADB
2. Reduce max connections in config.json
3. Close other network-intensive applications

## WebDAV Issues

### Windows cannot connect

1. Ensure WebClient service is running:
   ```cmd
   sc start WebDAV
   ```
2. Check BasicAuthLevel in registry:
   ```
   HKLM\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
   BasicAuthLevel = 2
   ```
3. Restart WebClient service

### Files not showing

1. Check the WebDAV URL path
2. Verify the folder exists in WSA
3. Check server logs

### Upload fails

1. Check available storage in WSA
2. Verify file permissions
3. Check max file size limits

## Root Access Issues

### Permission denied

1. Ensure Magisk is installed
2. Grant root access in Magisk Superuser tab
3. Verify: `adb shell su -c whoami` returns "root"

### SELinux blocking

1. Check SELinux mode: `adb shell su -c getenforce`
2. Set to permissive (temporarily): `adb shell su -c setenforce 0`

## Logging

### View Server Logs

```bash
adb shell su -c "cat /data/data/com.wsa.webdav/files/server.log"
```

### View Android Logcat

```bash
adb logcat -s WSAWebDAV
```

### Health Check

```bash
adb shell am broadcast -a com.wsa.webdav.HEALTH
adb shell cat /sdcard/Android/data/com.wsa.webdav/files/health.json
```

## Getting Help

If your issue isn't covered:

1. Check [GitHub Issues](https://github.com/WSA-Installer/wsa-webdav/issues)
2. Open a new [Bug Report](https://github.com/WSA-Installer/wsa-webdav/issues/new?template=bug_report.yml)
3. Include relevant logs and environment details