Support
Fix common setup problems
The problems people hit most often, with fixes you can follow. Still stuck? Ask for help from your setup plan and a person will reply.
Mac says the app “can't be opened” or is from an unidentified developer
- Only continue if you downloaded the app from the official link in your plan.
- Open System Settings → Privacy & Security.
- Scroll down: next to the message about the app, click “Open Anyway”, then confirm.
- If the message says the app is “damaged”, delete it and download it again from the official link.
Windows protected your PC (SmartScreen)
- Only continue if the file came from the official link in your plan.
- Click “More info”, check the app name, then “Run anyway”.
- If your work computer blocks it, ask your IT administrator — don't try to bypass company policy.
“brew: command not found”
- Homebrew isn't installed yet, or Terminal can't find it.
- Install it with the one-line command on brew.sh, then close and reopen Terminal.
- On Apple-silicon Macs, follow the “Next steps” Homebrew prints at the end of its install (it adds Homebrew to your PATH).
“winget is not recognized”
- Update “App Installer” from the Microsoft Store, then open a new Terminal window.
- On older Windows 10 versions, install Windows updates first.
- If you can't, use the official download option in your plan instead.
Flatpak: “No remote refs found” or “flathub not found”
- Add Flathub with the command for your distribution on flathub.org/setup.
- Restart your session (log out and in) so the app appears in your menu.
- Run the command from your plan again.
Docker: “Cannot connect to the Docker daemon” or “docker: command not found”
- Start Docker Desktop and wait until it says it is running (whale icon steady).
- Open a new terminal window and run the command from your plan again.
- On Linux, follow Docker's post-install steps or prefix the command with sudo.
“Port is already allocated” / address already in use
- Another program — or an earlier copy of the same app — is using that port.
- Run the “Remove it later” command from your plan, then run the install command again.
- Still stuck? Tell us and we'll give you a command with a different port.
It asks for an administrator password
- Some installers need your computer's own password to install for all users. Type it only into your computer's own prompt — never into a website or an email.
- NOVI never needs your passwords.
- On a work computer without admin rights, ask your IT administrator.
Installed, but the app doesn't open
- Restart your computer once, then try again.
- Check the requirements in your plan (operating-system version, memory, graphics).
- Ask for help below with the exact message you see — a screenshot description helps.