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

# getting-started

> Download, install, and configure Botify in minutes.

## System Requirements

| Requirement         | Minimum       | Recommended      |
| ------------------- | ------------- | ---------------- |
| Operating System    | Windows 10    | Windows 11       |
| RAM                 | 4 GB          | 8 GB+            |
| Internet Connection | Required      | Stable broadband |
| Privileges          | Administrator | Administrator    |

<Warning>
  Botify **must be run as Administrator**. It is required for Multi-Roblox mutex bypass, Working Set Trimmer, and process management. The app auto-elevates on startup — always accept the UAC prompt.
</Warning>

***

## Installation

<Steps>
  <Step title="Download Botify.exe">
    Download the latest `Botify.exe` from the **#releases** channel in the official Botify Discord server.
  </Step>

  <Step title="Run as Administrator">
    Right-click `Botify.exe` → **Run as administrator**. Accept the UAC prompt when it appears.
  </Step>

  <Step title="Authenticate">
    Log in with Discord OAuth2 (recommended) or enter your legacy license key.
  </Step>

  <Step title="Complete First-Time Setup">
    Enter your **PRC API Key**, **ERLC Server Code**, **PC Name**, and optionally a **Discord Webhook URL**.
  </Step>

  <Step title="You're Ready">
    Botify connects to MongoDB automatically and opens the main dashboard. Head to the **Accounts** tab to add your first alt account.
  </Step>
</Steps>

***

## Authentication

<Tabs>
  <Tab title="Discord OAuth2 (Recommended)">
    1. Click **Login with Discord** on the startup screen
    2. A browser window opens to Discord's OAuth2 authorization page
    3. Authorize Botify — scopes: `identify` + `guilds.members.read`
    4. Botify verifies you have the **"Client"** role in the Botify Discord server
    5. Your Discord User ID is stored locally and synced to MongoDB

    <Tip>
      Discord OAuth2 automatically detects your license tier (Standard vs. Enterprise) — no key entry needed.
    </Tip>
  </Tab>

  <Tab title="Legacy License Key">
    1. Click **Enter License Key** on the startup screen
    2. Enter your key in the format: `BOTIFY-XXXXX-XXXXX-XXXXX-XXXXX`
    3. The key is validated against the `botify_licenses` MongoDB collection
    4. On first activation, the key is **HWID-bound** to your machine

    | Plan         | Features Unlocked                                        |
    | ------------ | -------------------------------------------------------- |
    | `standard`   | All core features — 24/7 Alting, Normal Launch, all tabs |
    | `enterprise` | Everything + Enterprise Cluster mode                     |

    <Note>
      Activating on a new PC requires a manual HWID reset via Botify support.
    </Note>
  </Tab>
</Tabs>

***

## First-Time Setup

After authenticating, you'll be prompted to fill in the following fields:

| Field                   | Description                                     | Example                                |
| ----------------------- | ----------------------------------------------- | -------------------------------------- |
| **PRC API Key**         | Your ER:LC PRC API key for server queries       | `prc_xxxxxxxxxxxxxxxx`                 |
| **ERLC Server Code**    | Your private server code                        | `UTAHUSA`                              |
| **PC Name**             | Label for this machine in MongoDB               | `MainPC`                               |
| **Discord Webhook URL** | *(Optional)* Webhook URL for live notifications | `https://discord.com/api/webhooks/...` |

<Info>
  The MongoDB connection is established **automatically** using built-in credentials. No database setup is required.
</Info>

***

## Startup Sequence

Every time Botify launches, it runs through this sequence:

```text theme={null}
[1] Auto-elevate to Administrator (UAC prompt)
[2] Load local config (account_store.json)
[3] Connect to MongoDB Atlas
[4] Verify authentication (Discord role OR license key)
[5] Initialize Multi-Roblox mutex bypass (30s timeout)
[6] Start presence polling thread
[7] Start cookie auto-refresh background thread
[8] Open main dashboard
```

<Note>
  The Multi-Roblox mutex bypass initializes in the background. If initialization takes longer than 30 seconds, a warning is shown — but the app continues to function.
</Note>