# Login

## Automatic Login

* Click on "Discover Hub" button and if all goes well - you'll be logged in and will see all of your devices!
  * Note: You will need to be on the same network as your Hubitat Hub for this to work

{% embed url="<https://youtu.be/ZOPO_ORiY-c>" %}

## Manual Login

* If the Automatic Login doesn't work, you can manually enter your Hub's details. Hit the Manual button to show the IP address field.
  * Note: You will need to be on the same network as your Hubitat Hub for this to work
  * HD+ will attempt to fetch the MakerAPI app ID automatically

<figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FDbwzajZHppgI5N9pVjL0%2Fimage.png?alt=media&#x26;token=2215cce2-0263-4f1a-bc22-5b6dc842f537" alt=""><figcaption></figcaption></figure>

## Advanced Login

* If the Automatic or Manual logins don't work - you can still login but will need to first get some information from the Hubitat's MakerAPI page.
* Navigate to your Hub's webpage (typically [hubitat.local](http://hubitat.local))
* Click on Apps on the navigation bar and click on the MakerAPI app\
  ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FoKnRDcG2y7puOx7Rvpmv%2Fimage.png?alt=media\&token=2788b88b-5718-4602-96fe-eadef07615ff)
* When on the MakerAPI apps page, look at the URL in your browser. It should look like this: http\://\[HUB-IP]/installedapp/configure/**38**/mainPage. The "38" is the app ID. Enter this into the App ID field in the app\
  \
  ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2F2uiqUcrdyZ3Bua3Xpigr%2Fimage.png?alt=media\&token=55015bfb-062b-4a06-af81-4a86b8b6db29)
* Scroll down and look for "access-token". Enter this in the Access Token field for the app<img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mk-IVGVr8G2SBHju4g7%2F-Mk2TtbF1pPhdfdrZhIk%2F-Mk3Q48lYeRug-nqaH6x%2Fimage.png?alt=media&#x26;token=462fe3c8-77bf-475d-9644-0740b4f98ff3" alt="" data-size="original">
* If you want to use the app remotely (cloud support), scroll down further and look for a URL that starts with "cloud.hubitat.com". The value after /api/ is the Cloud token. Enter this into the Cloud token field of the app

  ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mk-IVGVr8G2SBHju4g7%2F-Mk2TtbF1pPhdfdrZhIk%2F-Mk3QgCWMLPcwr4LzEhy%2Fimage.png?alt=media\&token=927738a8-4cc9-4f8f-b17b-0e1c11ab015e)

<figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FeU9F03o9OifXTS9g5LNO%2Fimage.png?alt=media&#x26;token=aca152c2-3d23-4209-93f9-49fbc1491a97" alt=""><figcaption></figcaption></figure>

## Troubleshooting Logging In

If you're not able to login, here's some troubleshooting steps:

* If you have enabled Hub Security (username/password) on your Hub, the app should detect this and prompt you to login. However, if this isn't working you might want to try disabling Hub Security temporarily just to login to the app.
* The "Discover Hub" button uses UPnP to discover your hub on the network. UPnP isn't enabled on all networks and the app only waits a few seconds to discover the hub before timing-out and showing the IP address field. You can show it at any time by hitting the "Manual Entry" button. Enter your Hubitat Hub's IP address here and hit Login
  * The app does 2 things when you hit Login:
  * fetch the apps list page: <http://HUB.IP/installedapp/list> and look for "Maker API" app ID
  * fetch the Maker API settings page: <http://HUB.IP/installedapp/configure/APP.ID/mainPage> and look for access token ?access\_token=ACCESS\_TOKEN and cloud token <https://cloud.hubitat.com/api/CLOUD.TOKEN/apps>
* The automatic login process above could fail on future Hubitat Hub updates. Just report the issue on the Hubitat forums or send me a device log and I'll get it fixed!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://joe-page-software.gitbook.io/hubitat-dashboard/setup/login.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.