Dasharr

Troubleshooting

Common issues and solutions

Service Connection Issues

"Failed to connect to service"

  • Verify the service URL is accessible from the Dasharr container
  • Check API key/token is correct
  • Ensure the service is running
  • For Docker networks, use service names instead of localhost

"Unauthorized" errors

  • Regenerate API key in the service
  • Check for special characters in API keys
  • Verify API key permissions

Docker Issues

Container won't start

# Check logs
docker compose logs dasharr

# Verify port availability
lsof -i :3000

# Check Docker resources
docker system df

Build failures

# Clean Docker cache
docker system prune -a

# Rebuild without cache
docker compose build --no-cache

Performance Issues

Slow loading times

  • Check network connectivity to services
  • Verify service response times
  • Consider implementing caching
  • Check Docker resource limits

Configuration Not Saving

Web config not persisting

  • Check Docker volume permissions
  • Verify config directory is mounted
  • Check browser console for errors

Support

For issues or feature requests:

  1. Check existing issues in the repository
  2. Create a new issue with detailed information
  3. Include relevant logs and configuration (sanitize sensitive data)

Deployment

Deploy Dasharr in production