Troubleshooting
| Symptom | Check | Action |
|---|---|---|
| App fails to install | OS version / architecture | Ensure ctrlX OS V3.6.2; correct arm64/amd64 snap |
| Config not applied | Forgot restart | Restart after editing appdata.json |
| No connection | IP / Port wrong | Fix IPAddress / IPPort then restart |
| Wrong PSet behavior | PSet missing or malformed | Validate JSON & required fields |
| Log view broken | All columns enabled | Revert Logbook column layout |
Tips:
- Keep JSON minimal—remove unused fields.
- Change one PSet parameter at a time and restart.
Image Placeholder
/img/user-guide/logbook-error.png – Example error entry for missing PSet.
/img/user-guide/config-diff.png – Before/after config diff.