---
title: "Add a Windows machine for accounts"
locale: en
url: https://tlg.builera.app/en/docs/guides/nodes-windows
verified: 2026-10-24
app_version: "2.0"
---

# Add a Windows machine for accounts

Create a pairing code, install the worker on Windows, and manage its language through the tray icon.


You can use your own Windows machine or Windows VPS to keep Telegram connected. The machine must stay on and connected to the network to receive jobs.

## Who can do this

The workspace Owner or Manager creates the machine and pairing code. The installer needs to be signed in to Windows and able to run PowerShell under their own user account.

## Before you start

- A Windows machine meeting the compatibility requirements shown in the setup dialog.
- A network connection that allows downloading the installer and connecting to the service.
- Permission to use the machine for as long as the accounts need to operate.

The installer runs with standard permissions. You do not need to open PowerShell as Administrator. It downloads a separate Node environment and verifies the release.

The default capacity is **20 accounts**, according to `DEFAULT_CAPACITY_WINDOWS`. This is a capacity setting, not a guarantee that every Windows machine will run well at that level.

## Where to start

**Machines → Add machine → My Windows machine**.

## Steps

1. Enter a **Machine name** to identify it in the workspace.
2. Click **Create pairing code**.
3. Set **Language on the machine** to **Vietnamese** or **English**.
4. Click **Copy command**.

   ![The Add machine dialog, My Windows machine tab, with the machine name field and the create pairing code button](https://tlg.builera.app/docs-media/en/windows-pairing.webp "Name the machine before creating the code")

> [!IMPORTANT]
> The installation command contains a pairing code. Do not include the full command in images, public logs, or support conversations. Images must cover the entire command and code area, not just a few characters.

5. Open PowerShell on the Windows machine you want to connect.
6. Paste and run the entire copied command.

The command includes `lang=vi` or `lang=en` according to **Language on the machine**. Do not use an expired command or replace its code with another machine's code.

7. Follow the installer output in PowerShell.
8. Return to the app and wait for **Windows machine paired**.
9. Open the newly added machine to check its connection status.

### Use the tray icon

Right-click the Telegram-Auto icon to open the menu:

| Item | Function |
|---|---|
| **Open web app** | Opens the web app |
| **Pause** / **Resume** | Controls the worker on the machine |
| **View log** | Opens the local log |
| **Language** | Select **Vietnamese** or **English** |
| **Hide icon** | Hides the tray icon |

Language changes apply immediately and are saved in the machine configuration. The uninstaller also reads the saved language choice. **Hide icon** does not uninstall the software.

### Uninstall and reinstall

> [!WARNING]
> The uninstaller stops the worker and deletes the Telegram-Auto folder on the machine, including local data in that folder. Move accounts to another machine first if they need to keep operating.

Run the uninstaller from the path reported by the installer. The uninstall script is at `%LOCALAPPDATA%\TelegramAuto\uninstall.ps1`.

Deleting the machine record on the web only revokes the Windows machine's key. It does not automatically uninstall the local software.

To pair again, open the unpaired machine in the app, create a new code, and run the new installation command. After reinstalling, check each account's status. Do not assume old local sessions are still available.

## Result

The Windows machine appears in the workspace, and the worker receives jobs while connected. You can select the machine when adding an account.

## Check

Check the machine status on the web and the tray menu. Do not let Windows sleep or shut down while accounts need to run.

## If something goes wrong

Expired code: click **Create new code**, then copy the command again. Signature error or download mismatch: stop and check the message. Do not try to skip verification.

See [machine offline](https://tlg.builera.app/en/docs/troubleshooting/machine-offline).

## Do it with the API or MCP

Use [nodes.create_windows](https://tlg.builera.app/en/docs/reference/rest/nodes.create_windows) and [nodes.pairing_code](https://tlg.builera.app/en/docs/reference/rest/nodes.pairing_code). MCP names: `nodes_create_windows`, `nodes_pairing_code`.

The API creates pairing information. You still need to run the installer on the Windows machine.