# Root Access

WSA WebDev supports root filesystem access via Magisk.

## Requirements

- WSA installed
- Magisk installed and configured in WSA
- Root access granted to WSA WebDev

## Setup

### 1. Install Magisk in WSA

Follow the WSA Installer's Play Store installation process, which includes Magisk.

### 2. Grant Root Access

1. Open Magisk app in WSA
2. Go to Superuser tab
3. Grant root access to WSA WebDev

### 3. Enable Root Mode

Start the server in root mode:

```bash
adb shell su -c "sh /data/data/com.wsa.webdav/files/app.sh start"
```

## Root Filesystem Structure

When root access is enabled, the following paths are available:

```
http://127.0.0.1:8088/
  files/          # User storage (/storage/emulated/0)
  root/           # Root filesystem (/)
    data/       # App data
    system/     # System files
    vendor/     # Vendor files
```

## Security Considerations

- Root access provides full filesystem control
- Be careful when modifying system files
- The server runs as root — any vulnerability could compromise the system
- Consider disabling root access if not needed

## Troubleshooting

### Permission denied

1. Ensure Magisk is installed
2. Check Magisk Superuser tab for permissions
3. Try: `adb shell su -c whoami` — should return "root"

### Root commands fail

1. Check Magisk version (30.6+ recommended)
2. Reinstall Magisk in WSA
3. Check SELinux mode: `adb shell su -c getenforce`

### Cannot access /data/data

This is expected — app data directories have restricted permissions. Use the WebDAV server to access files instead.