Troubleshooting
Fix connection, capture, model, scheduling, and result-storage problems.
Start with the message Keep NI shows. For a disabled control, hover over it for an explanation. For a failed saved check, expand its row in History to read the full error. For Test step, read the error on the step’s card.
Chrome is disconnected or no profile appears
- Keep both Keep NI and Chrome running. Open Chrome in Keep NI’s top-right toolbar and check for a setup error.
- In the Chrome profile you want to use, open
chrome://extensionsand confirm Keep NI is installed and enabled. If it’s missing, install it through Download. - Return to Keep NI’s Chrome panel. When the profile appears, choose Use this profile and confirm Connected.
Select profile means a profile is available but needs your selection. Connecting… means setup is still running. If setup fails, follow the panel’s error, then relaunch Keep NI from Applications. Use Keep NI → Check for Updates… if you’re using an older release.
If the panel reports a duplicate profile, close the duplicate browser/profile and restart Keep NI. If Chrome remains stuck waiting for cleanup after a check ends, turn the extension off and on in chrome://extensions.
See Install and connect for the setup walkthrough.
The screenshot shows the wrong page or incomplete content
- Login page or wrong account: select the intended profile in Keep NI’s Chrome panel. Sign into the website directly in that Chrome profile, complete any verification, then test Open page again.
- Content is still loading: open the Open page card’s gear button, increase Screenshot delay, and test again.
- Unexpected layout: review Device viewport in the same settings. After changing it, capture again and adjust your Read regions to match.
Check now is disabled
Hover over Check now to see the specific reason. Common fixes are:
- Unsaved changes: save or discard edits to Steps, Schedule, and the monitor name.
- Chrome unavailable: connect the selected profile and wait for browser cleanup to finish.
- Another check is running: wait for it to finish or use its Stop button.
- AI model required: choose a configured model in every Read card’s gear settings, then save.
- Storage error: use the recovery control shown with the error; see Saving fails below.
You can use Check now with the schedule disabled.
Model setup or a Read step fails
For a failed or incorrect reading, test Open page first to capture the current webpage. A Read test can reuse an older screenshot.
Check that the region contains the intended value and enough nearby context to identify it. Correct the field name, Number/Text type, and reading instructions, then test Read again. For example, distinguish the current price from a crossed-out original price.
| Error | Recovery |
|---|---|
| Cloud key or connection error | Check the provider’s key in Settings → API keys and your connection. If the model list won’t load, choose Refresh Models. |
| Ollama server unavailable | Check that the configured server is running and its host and port are correct, then choose Connect again. |
| Ollama connects but lists no models | Install a compatible model on that server, then reconnect. |
| Model unavailable or unsupported | Select an available model that supports images and structured output. Appearing in the model list does not guarantee compatibility. |
| Request timed out | Increase Timeout in the Read card’s gear settings, reduce the region, or try another model. |
| Incomplete or invalid readings | Check every requested field. Try fewer fields in the step or choose another model. |
Save successful changes for future checks. See Set up AI models for model configuration.
Scheduled checks are missing or stay queued
Confirm Schedule enabled and the timing are saved. Review the preview’s days, hours, and time zone. Keep NI must be running, the Mac awake, and Chrome connected.
Queued means a check is waiting. Let another running check finish, reconnect Chrome, or resolve any model or storage error. Eligible queued work resumes automatically.
Missed times can combine into one check; Keep NI does not recreate every reading missed during sleep or downtime. See Schedule checks for timing and background-running options.
If a monitor runs again after you press Stop, its schedule may still be enabled or another check queued. Turn off Schedule enabled and save to stop future checks.
Saving fails
Check available disk space and access to the workspace in Application Support, then use the control shown with the error:
- Retry save or Retry storage retries saving or recovering monitor settings.
- Retry saving results saves the completed check without repeating browser or model work. Further stored checks for that monitor wait until recovery succeeds.
- Retry scheduling retries the scheduler’s storage operation so scheduling can resume.
A completed result that could not be saved is held in memory. Keep the app open while resolving it; force-quitting can lose that result.
History or Charts looks empty
Test step does not store results. Save the monitor, then use Check now. Only fully successful checks store reading values; a failed or cancelled check stores its outcome without partial readings.
In Charts, choose ALL and clear Filter fields…. Use Load older checks in History for earlier entries. If either view reports a loading error, choose Retry.
See Review results for chart gaps, missing readings, and saved check details.
Still need help?
Contact support@keepni.app with your Keep NI version, the action you tried, the exact error, and whether it happens every time. Include the model name and provider for Read problems. Leave out API keys and unrelated sensitive page content.