DocsAdvancedTroubleshooting

Troubleshooting

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

App Won't Start

If Nareli does not open after installation, the most common cause on macOS is Gatekeeper blocking the app because it was downloaded from the internet. Right-click (or Control-click) the Nareli app in your Applications folder and select "Open" from the context menu. You will see a dialog asking if you are sure you want to open it — click "Open" to allow it. This only needs to be done once. If the app still does not start, check System Settings > Privacy & Security and look for a message about Nareli being blocked. Click "Open Anyway" to allow it.

# If the app is damaged or quarantined, remove the quarantine flag:
xattr -cr /Applications/Nareli.app

# Verify the app is not corrupted:
codesign --verify --deep /Applications/Nareli.app

Nareli is a signed and notarized macOS application. If you see a "damaged" warning, try re-downloading from nareli.app.

Timer Not Working

If the timer does not start when you click the play button, check that the local server is running. The Nareli desktop app includes an embedded server that handles all data operations. Open the app's menu bar icon and check the server status indicator. If it shows as disconnected, try quitting and restarting the app. Also verify that ports 14000 and 14001 are not being used by another application. You can check this in Terminal with the lsof command.

# Check if the Nareli port is in use by another process
lsof -i :14000
lsof -i :14001

# If another process is using the port, you can kill it:
# kill -9 <PID>

Slack Connection Issues

If the Slack integration is not connecting or not fetching messages, verify the following: your Slack bot token is correctly entered in Settings > Services, the bot has been added to the channels you want to monitor, and your Mac has an active internet connection. If messages were previously working but stopped, your Slack token may have expired or been revoked. Generate a new bot token from your Slack app settings at api.slack.com/apps and update it in Nareli. Check the Dev tab in Settings (available in development mode) for detailed Slack processing logs.

The Slack bot needs the channels:history and channels:read scopes at minimum. If you are monitoring private channels, it also needs groups:history and groups:read.

AI Suggestions Not Appearing

AI suggestions require Ollama to be installed and running on your Mac. Ollama is a separate application that provides local AI model inference. First, verify that Ollama is installed and running by checking if it responds on its default port. Then verify that you have a compatible model downloaded. If Ollama is running but suggestions still do not appear, check that the Slack integration or activity analysis is enabled and that there is recent data to analyze. The AI processes data periodically (every 10 minutes for activity analysis), so suggestions may take a few minutes to appear after new activity.

# Check if Ollama is running
curl http://localhost:11434/api/version

# If not running, start it
ollama serve

# List available models
ollama list

# Pull a model if none are installed
ollama pull llama3.2

License Activation Problems

If your license key is not being accepted, double-check that you are entering it in the correct format: NRLI-XXXX-XXXX-XXXX-XXXX (all uppercase, with hyphens). Ensure your Mac has an internet connection, as the initial activation requires contacting the license server. If you receive a "not_a_member" error, make sure your Nareli account email matches the email used in the organization that owns the license. If you receive an "expired" error, check your subscription status at nareli.app/account. For "suspended" licenses, resolve any outstanding payment issues in the billing portal.

After the initial activation, the license works offline. If you are having trouble re-verifying, the cached token should keep working until it expires.

Database Issues

In rare cases, the SQLite database may become corrupted (for example, due to a power failure or disk error during a write). Symptoms include the app crashing on launch or showing missing data. First, try simply restarting the app — SQLite has built-in recovery for many types of corruption. If the problem persists, you can attempt a database integrity check and repair using the SQLite CLI. If the database is unrecoverable, you can start fresh by deleting it (the app will create a new one on launch).

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

# If the database is corrupted, try to recover:
sqlite3 ~/Library/Application\ Support/Nareli/local.db ".recover" | \
  sqlite3 ~/Library/Application\ Support/Nareli/local-recovered.db

# Replace the corrupted database with the recovered one:
mv ~/Library/Application\ Support/Nareli/local.db \
   ~/Library/Application\ Support/Nareli/local-corrupted.db
mv ~/Library/Application\ Support/Nareli/local-recovered.db \
   ~/Library/Application\ Support/Nareli/local.db

Always back up your database before attempting recovery. The cache.db file can be safely deleted — it only contains temporary data that will be recreated.

Resetting the App

If you want to completely reset Nareli to its initial state, quit the app and delete the data directory. This removes all databases, settings, and cached data. When you reopen the app, it will behave as if it was just installed, taking you through the setup wizard again. Your license key will need to be re-entered, but your Nareli account and subscription are unaffected. If you only need a partial reset (like clearing suggestions or resetting settings), you can do this from within the app's Settings page.

# Full reset — removes ALL local data
rm -rf ~/Library/Application\ Support/Nareli/

# Partial reset — only clear the cache
rm ~/Library/Application\ Support/Nareli/cache.db

# Then restart Nareli

Getting Support

If you are unable to resolve your issue using this guide, reach out to the Nareli support team. Email contact@nareli.app with a description of the problem, including what you were doing when the issue occurred, any error messages you see, your macOS version, and your Nareli version (visible in Settings > General). Free plan users receive community support. Pro users receive email support with a 48-hour response time. Business users receive priority support with a 24-hour response time. You can also visit nareli.app/contact to send a message directly from the website.

When reporting a bug, include your macOS version (found in Apple menu > About This Mac) and your Nareli version to help the support team diagnose the issue faster.