Skip to content

When something goes wrong

You seeLikely causeWhat to do
“Port 8090 is in use by another program”another deck or program on that portstop it, or change the profile’s port in Settings
“Port … is already used by …”two profiles share a portgive one of them another port
An instrument is red: No module named …its driver is not installedAdd from Hub, or install the package; then Restart
An instrument is red: could not open portunplugged, powered off, wrong portfix the cable or the port, then Restart
“Stopped unexpectedly”the process crashedread the Log tab; the last lines say why
“uv was not found”a development build without uvinstall uv, then Start again
The page in a tab is blank after a restartit reloaded before the deck answeredclick the tab and press Cmd/Ctrl+R
An optimizer is missing from the Optimize tabit failed to importthe Log tab has a [optimizer] … line with the reason
Every page answers 403the deck was opened by a host name it does not knowopen it by IP or computer name, or list the name in IVORYOS_ALLOWED_HOSTS
No notifications on macOSthe system refused them (unsigned build)Settings → Notifications shows the refusal, with a button to the system settings and a test

Where something failed that you may not be able to fix (a deck that would not start or stopped, an install that failed), the banner offers Send to IvoryOS. It gathers this session’s log, pip’s output for an install, the deck as names and classes only (never arguments, which hold addresses and serial numbers), the Python environment and installed packages, and redacts paths, user names, keys, tokens and emails. You read and can edit the exact text; nothing is sent before Send. The report goes to the IvoryOS team with an id you keep as a reference. If reports cannot be taken at the moment, the dialog offers Copy and a prefilled GitHub issue instead.

For questions and ideas, the Discord; for bugs and requests, GitHub issues.