step-by-step solution to resolve the Appium server startup issue:
1. Install Appium Drivers Manually
The error No plugins have been installed indicates Appium can’t find required drivers. Manually install them:
bash
# Uninstall existing drivers (if any)
appium driver uninstall uiautomator2
appium driver uninstall xcuitest
# Reinstall with correct versions
appium driver install uiautomator2@3.9.0
appium driver install xcuitest@7.34.1
2. Verify Driver Installation
Check installed drivers with:
bash
appium driver list --installed
Ensure both uiautomator2 and xcuitest appear with correct versions.
3. Set Environment Variables
Add these paths to your system environment variables (adjust paths if needed):
- ANDROID_HOME: Path to your Android SDK (e.g.,
C:\Users\<User>\AppData\Local\Android\Sdk)
- JAVA_HOME: Path to JDK (e.g.,
C:\Program Files\Java\jdk1.8.0_202)
- Add to PATH:
text
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
%ANDROID_HOME%\build-tools\<version>
%JAVA_HOME%\bin
4. Update Node.js and NPM
Although you have Node.js v22, Appium may work better with the LTS version (v20.x):
- Uninstall Node.js v22
- Install Node.js LTS from nodejs.org
- Update NPM:
bash
npm install -g npm@latest
5. Grant ADB Permissions
USB debugging issues can block Appium:
- Enable USB Debugging and USB Installation on your phone
- Run:
bash
adb kill-server
adb start-server
adb devices
- When phone is connected, allow debugging on the device prompt
6. Check Port Conflicts
Ensure port 4723 is free:
bash
netstat -ano | findstr ":4723"
If occupied, terminate the process or change Appium port in Katalon settings.
7. Katalon Configuration
In Katalon Studio:
- Go to Project Settings > Execution > Default Mobile
- Set Appium installation type: Local
- Specify explicit paths to:
appium.cmd (e.g., C:\Users\<User>\AppData\Roaming\nvm\version\appium.cmd)
- Node.js (e.g.,
C:\Program Files\nodejs\node.exe)
8. Firewall/Antivirus Exceptions
Allow these through your firewall/antivirus:
- Node.js (
node.exe)
- Java (
java.exe)
- ADB (
adb.exe)
- Appium process
9. Reinitialize Appium Setup
bash
# Clean global node_modules
npm uninstall -g appium
npm cache clean --force
# Reinstall Appium globally
npm install -g appium@2.12.1
# Verify installation
appium --version
Alternative: Use Katalon’s Bundled Appium
In Katalon:
- Go to Project Settings > Execution > Default Mobile
- Set Appium installation to: Bundled
Final Verification
Run this command to start Appium manually:
bash
appium --log-level info
Look for these lines in output:
text
[Appium] Appium REST http interface listener started on 0.0.0.0:4723
[Appium] Drivers available: uiautomator2, xcuitest
If the issue persists after these steps, share:
- Output of
appium driver list --installed
- Full Appium logs when starting from command line
- Katalon’s mobile execution settings screenshot