Back to Home

Help Center

Here are some frequently asked questions. Click a title to view the details.

Windows: Download the installer https://www.irta.app/dl/irta.exe

macOS: Download the package https://www.irta.app/dl/irta.pkg

Linux: Run the one-click install script in the terminal (supports x86_64 and aarch64/Arm):

curl -fsSL https://www.irta.app/install.sh | bash

Note: Linux currently only supports the controlled side, not the controller mode. After installation you can run irta --help to view the available commands.

Android / iOS: The mobile version is coming soon.

iRta supports two convenient ways to transfer files:

Drag and drop: Simply drag a local file onto the remote desktop screen to transfer it.

Copy and paste: Copy a file locally, then paste it on the remote screen to send it to the remote computer.

iRta supports configuring a custom relay server. The setup varies by platform:

Windows: Create a file named Relay.ini in the iRta install directory (default C:\Program Files\iRta) with the following content:

server = turn.your-turn-server.com port = 3478 username = user password = pass force = 0

macOS: The configuration is the same as Windows, except Relay.ini must be placed in your home directory, i.e. ~/Relay.ini (where ~ means your home directory, for example /Users/yourname/).

Android / iOS: Go to "My Account" → "Configure Relay Server" and fill in the fields.

Fields

  • server: Relay server address
  • port: Port, usually 3478
  • username / password: Authentication account and password
  • force: Connection mode. 0 = try P2P first, then fall back to the relay on failure; 1 = route all traffic through the relay by default, skipping P2P

Tips

  • For a self-hosted relay server, we recommend the open-source project coturn.
  • Registered Cloudflare users can request 1 TB of free TURN server traffic per month.
  • Note: Self-hosted relay servers do not support TLS mode.

Download the latest version from the official website: https://www.irta.app/dl/irta.exe

1. Open an elevated Command Prompt: Press the Win key, type cmd, right-click "Command Prompt" and choose "Run as administrator" (you can also press Win + X and choose "Terminal (Admin)"). A black window will open.

2. Go to the Downloads folder: Files are saved to the "Downloads" folder by default. In the black window, type the following and press Enter:

cd %USERPROFILE%\Downloads

3. Run the update command: Type the following and press Enter:

iRta.exe -update

4. Wait for it to finish: When you see the update-complete message, reopen iRta.

First confirm that you are running Windows 10 or later (64-bit).

If you see "WebView2 missing, unable to run", your system is missing the Microsoft Edge WebView2 runtime. Download and install it from the Microsoft website (download here), then restart iRta.

iRta needs to allow outbound TCP port 80, 443, and any custom relay port.

Windows Firewall: In "Advanced Settings" → "Outbound Rules", add an allow rule for iRta.exe and enable it for all network types.

In corporate or school networks, contact your network administrator to allow the domains and ports used by iRta.

Windows
Open the built-in "Programs and Features" (found in "Control Panel" or "Settings" → "Apps"), find iRta in the list, and click "Uninstall".

macOS
Open "Finder" → "Applications", then drag iRta to the Trash.

Linux
Run irta --help in the terminal and use the uninstall command shown in its output.