> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/user-guide/authentication.md).

# Authentication

Orbitron requires **user authentication before any functionality can be accessed**. Only users who have been **invited to the platform** can log in.

> If you have not yet been invited, please contact your **AlphaCode administrator** or your **organization's Orbitron manager** to request access.

***

### 🚪 Login Requirement

* You **must be logged in** to use Orbitron.
* If you launch Orbitron for the first time and you're not logged in, an **authentication dialog will appear automatically**.
* You can also **manually open the login dialog** at any time by:
  * Typing the command:

    ```bash
    /login
    ```
  * Or using the shortcut:

    ```
    Ctrl + A
    ```

***

### 🌐 Login via Web Browser

You can log in to Orbitron using your browser by selecting:

<div align="left"><figure><img src="/files/7utdTq5VwG3PF1pHSmln" alt="" width="563"><figcaption></figcaption></figure></div>

This will launch your default web browser and guide you through the authentication process.

***

### 🔑 Login via Token Input

Alternatively, you can manually authenticate by entering your access tokens:

**Steps:**

1. Visit the [Orbitron Web](https://orbitron.megaone.com/en/dashboard) interface and log in.
2. Navigate to the **Settings** menu at the top.
3. Select the **“Authentication Tokens”** tab.
4. Copy your `Access Token` and `Refresh Token`.

<div align="left"><figure><img src="/files/k43wjUwx4VKcEYyVGqsR" alt="" width="563"><figcaption></figcaption></figure></div>

5. Paste them into the Orbitron CLI prompt when requested.

<div align="left"><figure><img src="/files/ucVbXXGDUqBkyXYRiHVe" alt="" width="563"><figcaption></figcaption></figure></div>

> 💡 Use this method if your terminal does not support browser login or you're working in a headless environment.

***

#### ✅ Summary

| Step              | Action                                          |
| ----------------- | ----------------------------------------------- |
| 🔐 Authentication | Browser login or token-based login              |
| 🔑 Token Location | Orbitron Web → Settings → Authentication Tokens |

***

### 🔧 Troubleshooting

#### Authentication Failure with Cloudflare WARP

> 💡 This issue can occur in corporate or organizational environments using WARP.

**Symptoms**

* Authentication errors during login
* Browser login fails or shows infinite loading

**Cause**

* Cloudflare WARP blocks the domains required for OAuth authentication

**Solution**

1. Contact your Cloudflare Zero Trust administrator
2. Request adding the following domains to the Split Tunneling **Exclude list**:
   * `oauth2.googleapis.com`
   * `supabase.co`
3. Restart Orbitron after the settings are applied