Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Unraid Connect API Issue: /graphql endpoint returns 404 despite plugin being up-to-date

Featured Replies

Hello,

I am writing to report an issue with the Unraid Connect API. I am attempting to configure the unraid_api custom integration in Home Assistant, but the setup consistently fails.

I have performed a detailed analysis of the problem, and the logs indicate that the API endpoint required by the integration is not being correctly served by the Unraid web server.

Full Log Traceback from Home Assistant: The Home Assistant logs show the following recurring error during the configuration process, even after reinstalling the integration:

aiohttp.client_exceptions.ContentTypeError: 404, message='Attempt to decode JSON with unexpected mimetype: text/html', url='http://192.168.178.33/graphql'

This error points directly to a 404 Not Found response when the integration attempts to access the /graphql endpoint, which is provided by the Unraid Connect plugin.

Steps I Have Taken to Diagnose:

  1. I have confirmed that the main Unraid web interface is reachable at the specified IP address (http://192.168.178.33). A curl command to this URL returns the expected HTML content.

  2. I have verified that the Unraid Connect Plugin is up-to-date.

  3. My Unraid OS version is 7.1.4.

  4. The Unraid Connect plugin version is limetech2025.07.30.2047.

  5. The issue persists even after a full server reboot.

Conclusion: Based on the evidence, it appears that while the Unraid Connect plugin is installed and running, the /graphql endpoint it is supposed to provide is not being exposed correctly. This is preventing the Home Assistant integration from communicating with the server.

This issue is also being discussed by other users. You can find more context here: GitHub Issue: https://github.com/chris-mc1/unraid_api/issues/3

Please investigate this as it seems to be an issue on the Unraid Connect side, possibly a bug with how the API endpoint is initialized in the latest version.

Thank you for your time and support.

  • 2 weeks later...
  • Community Expert

Just followed up on that GitHub thread. I’m very interested in solving this for you and others, and I think I need a bit more logging and information about what the exact request from HA is that is failing.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.