> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reconnect-tool.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Reconnect Errors and How to Fix Them

> Solutions to the most frequent Reconnect errors, including license issues, HWID limits, device connection problems, and Roblox rejoin failures.

Most Reconnect issues fall into a small set of categories and have straightforward fixes. Work through the accordion below that matches the error or behavior you're seeing — each entry explains the cause and walks you through the solution.

<AccordionGroup>
  <Accordion title="&#x22;Invalid license key&#x22;">
    **Cause:** The key has already been redeemed on another account, has expired, or contains a typo.

    **Fix:**

    1. Check for typos — make sure there are no leading or trailing spaces.
    2. Open your [Reconnect dashboard](https://app.reconnect-tool.com) and go to the **Subscriptions** tab. If your subscription is listed there, the key has already been applied to your account and you don't need to enter it again.
    3. If the key should be valid but still fails, contact support in the Reconnect Discord server at [discord.gg/reconnect](https://discord.gg/reconnect).
  </Accordion>

  <Accordion title="&#x22;HWID limit reached&#x22;">
    **Cause:** All device slots included in your subscription are currently occupied by other registered devices.

    **Fix:**

    1. Open your [Reconnect dashboard](https://app.reconnect-tool.com) and go to the **Devices** section.
    2. Find a device you no longer use and remove it.
    3. The slot frees up immediately — restart the Reconnect client on your new device to register it.
  </Accordion>

  <Accordion title="Device not appearing in dashboard">
    **Cause:** The client may still be connecting, or your license key hasn't been validated yet.

    **Fix:**

    1. Wait **10–15 seconds** after starting the client — registration isn't always instant.
    2. Check that the device has a working internet connection.
    3. Restart the Reconnect client.
    4. Confirm your license key was redeemed successfully in the **Subscriptions** tab of your dashboard.
  </Accordion>

  <Accordion title="Client crashes on startup">
    **Cause:** Missing dependencies (Termux), a corrupted binary (Windows), or Android killing the process in the background.

    **Fix for Termux:**

    Run the following in Termux, then re-run the setup script:

    ```bash theme={null}
    pkg update && pkg upgrade -y
    ./setup.sh
    ```

    **Fix for Windows:**

    Re-download the executable from your [dashboard downloads page](https://app.reconnect-tool.com/downloads/windows). Right-click the file and select **Run as Administrator**.
  </Accordion>

  <Accordion title="Roblox not rejoining after disconnect">
    **Cause:** The check interval hasn't elapsed yet, or the rejoin method failed.

    **Fix:**

    1. Wait for the next check interval. On the **Free** plan, the interval can be up to **480 seconds** — give it time before assuming something is broken.
    2. Consider upgrading to **Pro or higher** for shorter check intervals and more reliable rejoin methods.
    3. If you're on Termux, check the client logs in your terminal for specific error messages.
  </Accordion>

  <Accordion title="&#x22;Connected&#x22; then immediately &#x22;Disconnected&#x22; in dashboard">
    **Cause:** The WebSocket connection between the client and the Reconnect servers is unstable. This is almost always a network issue on the device side.

    **Fix:**

    1. Check the internet connection on your device — try opening a webpage to confirm it's working.
    2. Disable battery optimization for Termux (Android) so the OS doesn't interrupt the connection. See [Keeping Termux Running](/getting-started/installation-termux#keeping-termux-running-in-the-background) for steps.
    3. Restart the Reconnect client and monitor the dashboard for a stable connection.
  </Accordion>
</AccordionGroup>

<Tip>
  If none of the above fixes your issue, head to the Reconnect Discord server at [discord.gg/reconnect](https://discord.gg/reconnect) and open a support ticket. Include your device type, the exact error message, and any relevant client logs.
</Tip>
