Skip to main content

Troubleshooting

This guide helps you diagnose and solve common issues with OpenHuman.

Application Issues​

App Won't Start​

  1. Check system requirements (Node.js >= 18.0.0, 4GB+ RAM)
  2. Check available disk space (2GB+ required)
  3. Restart the application
  4. Check logs at ./logs/openhuman.log

Slow Performance​

  1. Close other applications to free up memory
  2. Reduce the number of connected integrations
  3. Check if network connection is stable
  4. Try switching to a faster model

Memory Usage Too High​

  1. Reduce sync frequency in settings
  2. Limit the number of indexed data sources
  3. Enable local AI to reduce cloud API calls

Connection Issues​

Cannot Connect to Server​

  1. Check your internet connection
  2. Verify the API endpoint is accessible: 
    curl -I https://api.tinyhumans.ai/health
  3. Check if firewall is blocking the connection
  4. Try using a different network

OAuth Login Fails​

See Troubleshooting Sign-In for detailed OAuth troubleshooting steps.

Data Issues​

Data Not Syncing​

  1. Check if auto-fetch is enabled in settings
  2. Verify integration credentials are valid
  3. Check sync interval settings
  4. Try manual sync

Search Not Working​

  1. Check SearXNG settings if using self-hosted search
  2. Verify network connection
  3. Try regenerating the search index

Installation Issues​

npm Install Fails​

# Clear npm cache
npm cache clean --force

# Reinstall
rm -rf node_modules package-lock.json
npm install

Permission Denied​

On Linux/Mac, you may need to:

sudo npm install -g openhuman-sdk

Getting Help​

If you continue to experience issues:

  1. Check the FAQ page
  2. Search existing GitHub issues
  3. Ask on Discord

Next Steps​