Fix blocked installation or startup
Your goal
Separate unsupported platforms, OS blocking, old instances and backend loading.
Before you start
Record app/OS versions, download source and redacted errors.
Steps
- Check Windows x64 or macOS 14+ Apple Silicon and the matching package.
- If the OS blocks it, verify the official Release source and read the exact reason; keep global protections enabled.
- Quit any old instance through its tray before reopening. Closing the window may leave it running.
- A page refresh does not update Python/Electron; restart LeafLoom after source changes.
- Open the log folder from desktop General settings and capture the first startup error with private details removed.
What to expect
You can identify whether the failure is installation, a busy port, a backend mismatch or the UI.
If it does not work
Do not delete notes, models, credentials or history to fix a blank page. Report reproducible steps and redacted logs if it persists.
Next steps
- What to prepare before you start
- Set language, folders and background behavior
- Frequently asked questions and support