Troubleshooting

Install issues

"arx" command not found

Restart terminal first. On Windows verify launcher path exists.

# Windows launcher path
%USERPROFILE%\AppData\Local\Microsoft\WindowsApps\arx.bat

Linux permission issues

chmod +x install.sh
./install.sh

PowerShell execution policy blocks script

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Ollama/model issues

ollama list
ollama pull gemma4:e2b
ollama serve

Runtime service issues

arx status
arx doctor
arx logs dashboard --lines 120
arx logs server --lines 120
arx shutdown
arx start

Port conflicts

ARX dashboard default is 18890. If conflict occurs, rerun installer with a different port.

Tunnel issues

arx tunnel status
arx tunnel setup
arx tunnel setup --url your-name.playit.gg:12345 --enable

Need help

• GitHub Issues: https://github.com/Adichapati/ARX/issues
• Support: support@arxmc.studio