DocsAdvancedTroubleshooting

Troubleshooting

Solutions for common issues with Nareli, including startup problems, connection errors, and data recovery.

Common Errors

Quick reference for the most frequently encountered issues.

Symptom	Likely Cause	Fix
App won't open	macOS Gatekeeper blocking	Right-click > Open, or System Settings > Privacy & Security
"Damaged" app warning	Quarantine flag set	Run: xattr -cr /Applications/Nareli.app
Timer not starting	Local server not running	Restart the app; check ports 14000/14001
Slack not connecting	Expired or revoked token	Generate new token at api.slack.com/apps
No AI suggestions	Ollama not running	Run: ollama serve
License suspended	Payment failed	Update payment method at app.nare.li/account

App Won't Start

Usually caused by macOS Gatekeeper blocking the app on first launch.

Right-click (or Control-click) Nareli.app in Applications and select "Open"

Click "Open" in the dialog to allow it (one-time only)

If still blocked: System Settings > Privacy & Security > Click "Open Anyway"

# Remove quarantine flag if needed
xattr -cr /Applications/Nareli.app

# Verify app signature
codesign --verify --deep /Applications/Nareli.app

Nareli is signed and notarized. If you see a "damaged" warning, re-download from app.nare.li.

Timer Not Working

The timer depends on the embedded local server. If disconnected, restart the app.

Check the menu bar icon for server status

If disconnected, quit and restart Nareli

Verify ports 14000 and 14001 are not used by another app

# Check if ports are in use
lsof -i :14000
lsof -i :14001

Slack Connection Issues

Verify your bot token, channel access, and internet connection.

Check that the Slack bot token is entered in Settings > Services

Confirm the bot has been added to the channels you want to monitor

If messages stopped working, regenerate the token at api.slack.com/apps

Check the Dev tab in Settings for detailed processing logs

Required scopes: channels:history, channels:read. For private channels: groups:history, groups:read.

AI Suggestions Not Appearing

Ollama must be installed, running, and have a model downloaded.

Verify Ollama is running: curl http://localhost:11434/api/version

If not running: ollama serve

Check for installed models: ollama list

If no models: ollama pull llama3.2

Wait up to 10 minutes - activity analysis runs periodically

Account & License Issues

Licenses are tied to your Nareli account and activate automatically when you sign in.

Sign out of the desktop app, then sign back in

Check your subscription status at app.nare.li/account

If you see "not_a_member" - make sure your account email matches your organization

If "suspended" - resolve payment issues in the billing portal

If "expired" - renew your subscription at app.nare.li/account

Error	Meaning	Resolution
not_a_member	Your account is not in the license's organization	Check your email matches the org, or ask the admin to invite you
expired	Subscription has ended	Renew at app.nare.li/account
suspended	Payment failed	Update payment method in billing portal
No error but limited features	Free plan active	Upgrade at app.nare.li/account

After sign-in, the app caches a signed token for offline use. If offline verification fails, reconnect to the internet and sign in again.

Database Issues

Database corruption is rare but can happen after a power failure or disk error.

Restart the app - the database engine has built-in recovery for many issues

Run an integrity check (see code below)

If corrupted, recover the database using the .recover command

If unrecoverable, delete the file - the app creates a fresh one on launch

# Check integrity
sqlite3 ~/Library/Application\ Support/Nareli/local.db "PRAGMA integrity_check;"

# Recover a corrupted database
sqlite3 ~/Library/Application\ Support/Nareli/local.db ".recover" | \
  sqlite3 ~/Library/Application\ Support/Nareli/local-recovered.db

Always back up before recovery. cache.db can be safely deleted - it's recreated automatically.

Resetting the App

Delete the data directory for a full reset. Your account and subscription are unaffected.

Quit Nareli completely

Delete the data directory (see code below)

Reopen the app - it starts fresh with the setup wizard

# Full reset
rm -rf ~/Library/Application\ Support/Nareli/

# Partial reset (cache only)
rm ~/Library/Application\ Support/Nareli/cache.db

Getting Support

If you cannot resolve the issue, contact the Nareli support team.

Email contact@app.nare.li with your macOS version and Nareli version
Or visit app.nare.li/contact to send a message
Free plan: community support
Pro plan: email support (48h response)
Business plan: priority support (24h response)

Include your macOS version (Apple menu > About This Mac) and Nareli version (Settings > General) for faster diagnosis.