Ergora Remote — Setup guide

Install Ergora Remote

Takes about 3 minutes. You'll need your agent token from the portal — we'll walk through where to find it.

1

Get your agent token

You need a one-line token from your Ergora portal. It starts with eal_.

  1. Log into ergora.cloud/portal
  2. Press Cmd + K (or Ctrl + K on Windows/Linux)
  3. Search for Ergora Remote and open it
  4. If you haven't subscribed yet, click Get Ergora Remote — $39/mo and complete checkout
  5. Click Generate token and copy the eal_… value

The token is shown once. Copy it somewhere safe before closing the dialog — you can always rotate it if you lose it.

2

Open Terminal

Two ways to open Terminal:

  1. Press ⌘ + Space, type Terminal, press Enter
  2. Or: Finder → Applications → Utilities → Terminal

A black-and-white window will open. That's where the commands go.

3

Run the one-line installer

Paste the command below into your terminal. Replace eal_your_token_here with the token you copied in step 1.

curl -sSL https://ergora.app/install.sh | ERGORA_TOKEN=eal_your_token_here bash

You'll see each step print as it runs: Node check, download, install, done.

4

Start the agent

The installer puts everything at ~/ergora-remote. To start the agent:

cd ~/ergora-remote npm run dev

Within a few seconds your device will appear online in the portal's Ergora Remote view.

5

(Optional) Run it in the background

Install pm2 so the agent keeps running after you close Terminal and auto-starts after reboot:

npm install -g pm2 cd ~/ergora-remote pm2 start "npm run dev" --name ergora-remote pm2 save pm2 startup # follow the printed instructions once

Something went wrong?

Most common issues:

  • "node: command not found" — Install Node.js 20+ and re-run.
  • Token not working — rotate it from the portal and edit ~/ergora-remote/.env.
  • Device stays offline — make sure the terminal window is open (or you've set up pm2 in step 5).
  • Other — email hello@ergora.cloud, we'll help.