Instalación

Instalá Agora en Ubuntu o Debian con un solo comando, o compilalo desde el código fuente.

Requisitos

Ubuntu o Debian, x86_64 o arm64, con systemd.
Google Chrome o Chromium.
Xvfb.
Acceso root (sudo) para instalar el binario, el usuario de sistema agora y el servicio.

El instalador se encarga de todo: Xvfb, VA-API, Google Chrome (Chromium en arm64) y el usuario de sistema.

Instalación en una línea

curl -fsSL https://agora.olimpia.dev/install.sh | sudo sh

Descarga la última versión para tu arquitectura y verifica su SHA-256 (o compila desde el código fuente si todavía no hay ninguna versión publicada), instala /usr/local/bin/agora, crea el usuario sin privilegios agora que corre las apps y los navegadores, y habilita el servicio de systemd agora. Si lo volvés a correr, actualiza en el lugar y reinicia el servicio solo si algo cambió. Si preferís, leé el script antes: agora.olimpia.dev/install.sh.

Si Claude Code, Codex o Paseo están instalados para el usuario que corrió sudo, también registra el servidor MCP de Agora (agora mcp), instala el skill de Agora e instala el plugin de Paseo.

Pasá las opciones después de sh -s --, por ejemplo curl -fsSL https://agora.olimpia.dev/install.sh | sudo sh -s -- --no-agents:

Opción	Qué hace
`--version vX.Y.Z`	Instala esta versión en lugar de la última.
`--prefix DIR`	Instala en `DIR` en lugar de `/usr/local`.
`--source DIR`	Compila desde un checkout local en lugar de descargar.
`--no-agents`	No configura Claude Code, Codex, el skill ni Paseo.
`--no-paseo`	No instala el plugin de Paseo.

Comprobá que el daemon esté levantado y mostrá tu token de administrador:

systemctl status agora
curl -s http://127.0.0.1:7788/v1/health
sudo agora token

Abrí el dashboard

El daemon escucha solo en 127.0.0.1:7788. Abrí http://127.0.0.1:7788 en la misma máquina y pegá el token de administrador. Desde otra máquina, usá un túnel SSH:

ssh -L 7788:127.0.0.1:7788 you@your-server

Para tener acceso remoto permanente, poné Agora detrás de un túnel autenticado, como Cloudflare Tunnel con Access. Mirá el modelo de seguridad.

Compilar desde el código fuente

Necesitás Go, un toolchain de C y los headers de x264 y libva (Agora codifica H.264 a través de cgo, con VA-API para codificar por GPU cuando hay un dispositivo disponible).

sudo apt install xvfb libx264-dev libva-dev pkg-config build-essential
git clone https://github.com/olimpiacloud/agora && cd agora
make build
sudo install -m 0755 bin/agora /usr/local/bin/agora
sudo useradd --system --create-home --home-dir /var/lib/agora-apps --shell /usr/sbin/nologin agora
sudo cp deploy/agora.service /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now agora

Correrlo sin systemd

agora serve corre en primer plano. Como root guarda el estado en /var/lib/agora; como usuario normal, en ~/.agora.

agora serve --listen 127.0.0.1:7788 --home ~/.agora

Flag	Valor por defecto	Qué hace
`--listen`	`127.0.0.1:7788`	Dirección HTTP. Las direcciones que no son loopback se rechazan salvo que `AGORA_ALLOW_PUBLIC=1`.
`--home`	`/var/lib/agora` o `~/.agora`	Directorio de estado (también `AGORA_HOME`).
`--apps-user`	`agora`	Usuario sin privilegios para las apps y los navegadores cuando corre como root.
`--chrome`	detección automática	Binario de Chrome o Chromium.
`--rtc-port`	`0`	Puerto UDP único para WebRTC (`0` elige puertos efímeros).
`--rtc-interfaces`	todas	Interfaces separadas por comas para los candidatos de WebRTC.
`--rtc-loopback`	`true`	Ofrece candidatos ICE de loopback.
`--idle-after`	`5m`	Marca un workspace como inactivo después de este tiempo sin actividad.
`--suspend-after`	`0`	Suspende los workspaces inactivos después de este tiempo (`0` significa nunca, por defecto).

Siguiente: el inicio rápido.