> ## 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.

# Install ReconnectX on Android Using Termux (F-Droid)

> Run ReconnectX on Android using Termux for a lightweight, terminal-based setup. Requires F-Droid — the Play Store version will not work.

The Termux method lets you run ReconnectX on Android through a terminal environment, giving you full control over the process without needing a separate app install. This approach is ideal if you prefer a CLI-based workflow or want to run multiple accounts on a single device.

<Warning>
  You must install Termux from **F-Droid**, not the Google Play Store. The Play Store version is outdated and the installer will fail.
</Warning>

## Prerequisites

Before you begin, make sure you have the following:

* **Termux** installed from [F-Droid](https://f-droid.org/en/packages/com.termux/) (not Google Play)
* An active **Reconnect subscription**
* A Reconnect account at [app.reconnect-tool.com](https://app.reconnect-tool.com)

## Installation

<Steps>
  <Step title="Install Termux from F-Droid">
    Download and install Termux from the [F-Droid repository](https://f-droid.org/en/packages/com.termux/). Open Termux once installed to confirm it launches correctly.

    <Warning>
      Do **not** install Termux from the Google Play Store. The Play Store version is outdated and incompatible with the ReconnectX installer.
    </Warning>
  </Step>

  <Step title="Grant storage access">
    Inside Termux, run the following command and tap **Allow** when Android prompts for storage permission:

    ```bash theme={null}
    termux-setup-storage
    ```
  </Step>

  <Step title="Get your personal install command">
    Your install command is unique to your account. To retrieve it:

    1. Join the Reconnect Discord server at [discord.gg/reconnect](https://discord.gg/reconnect)
    2. Go to the **#download** channel
    3. Click the **Get Install Command** button
    4. The bot sends your personal, one-time command in a private message — only you can see it

    <Warning>
      Your install command is tied to your account. **Never share it with anyone.** Sharing your install command results in an automatic permanent ban.
    </Warning>
  </Step>

  <Step title="Run the install command in Termux">
    Paste your personal command into Termux and press Enter. It looks like this:

    ```bash theme={null}
    curl -sL https://dl.reconnect-tool.com/install.sh | bash -s -- YOUR_TOKEN
    ```

    The installer automatically handles everything:

    * Updates Termux packages
    * Installs all required dependencies
    * Downloads and launches ReconnectX
  </Step>
</Steps>

## After Installation

Once the installer finishes, you don't need the install command again. From the second run onwards, just open Termux and run:

```bash theme={null}
python3 ~/.reconnect/reconnect.py
```

Your device will appear as **Online** in your Reconnect dashboard within a few seconds of the client starting.

## Updating ReconnectX

To update to the latest version, go to the **#download** channel in Discord and click **Get Update Command**. Run the command in Termux — no token or reinstall required:

```bash theme={null}
curl -sL https://dl.reconnect-tool.com/update.sh | bash
```

## Troubleshooting

If you run into issues during or after installation, use the table below to find a fix.

| Problem                   | Fix                                                                                          |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| Permission denied         | Run `termux-setup-storage` and tap **Allow**                                                 |
| Installer fails           | Check your internet connection and try again                                                 |
| Token expired             | Click **Get Install Command** again in Discord for a fresh token                             |
| Login / account not found | Register at [app.reconnect-tool.com/register](https://app.reconnect-tool.com/register) first |
| App crashes on start      | Run `pkg update -y` in Termux, then retry                                                    |

## Keeping Termux Running in the Background

Android's battery optimization frequently kills background processes like Termux. Disable it to keep ReconnectX running reliably:

**Settings → Apps → Termux → Battery → Unrestricted**

<Note>
  On some devices (particularly Huawei, Xiaomi, and OPPO), the setting is located under:

  **Battery → App Launch → set Termux to Manual**, then enable all three toggles:

  * Auto-launch
  * Secondary launch
  * Run in background
</Note>