Inicio / Instalar en Linux

Instala el agente de Pling en Linux

El agente del host de Pling se ejecuta en cualquier servidor o estación de trabajo Linux, transmite métricas de CPU, memoria, disco y red a la app de iOS, retransmite sesiones SSH/Mosh compartidas, ejecuta comandos programados y expone una pequeña interfaz web local. Binarios nativos para amd64 y arm64; funciona en Ubuntu, Debian, Fedora, Arch, Alpine y Raspberry Pi OS.

Una sola línea con curl (recomendado)

El instalador descarga el binario adecuado para tu arquitectura, te solicita tu token de API y registra un servicio de systemd que se inicia automáticamente al arrancar.

curl -sSL https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.sh | sh

Verifica que se está ejecutando:

pling status
systemctl status pling
journalctl -u pling -n 50 --no-pager

Where to find your token: open the iOS app, go to Settings → Hosts → Add agent. Copy the token and paste it when the installer asks.

Instalación manual

Elige esto cuando quieras control total o desplegar mediante gestión de configuración. Reemplaza amd64 por arm64 en Raspberry Pi o servidores arm64.

curl -L -o pling \
  https://github.com/Jeramo/pling-agent/releases/latest/download/pling-linux-amd64
chmod +x pling
sudo mv pling /usr/local/bin/
sudo mkdir -p /etc/pling
sudo tee /etc/pling/config.toml >/dev/null <<'EOF'
api_url = "https://agent.plingpush.com"
token = "YOUR_TOKEN_HERE"
metrics_interval = 60
EOF

Ejecútalo directamente para confirmar:

pling serve

Unidad de systemd

Coloca esto en /etc/systemd/system/pling.service y luego systemctl enable --now pling:

[Unit]
Description=Pling host agent
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/pling serve
Restart=on-failure
RestartSec=5
User=root

[Install]
WantedBy=multi-user.target

Configurar

Edita la configuración en $EDITOR:

sudo pling config edit

O actualiza solo el token y reinicia el servicio:

sudo pling set-token <NEW_TOKEN>

Actualizar

Vuelve a ejecutar el script de instalación. Reemplaza el binario, conserva tu configuración y reinicia la unidad de systemd:

curl -sSL https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.sh | sh

Desinstalar

sudo pling uninstall

Elimina el binario, la configuración y la unidad de systemd.

Preguntas frecuentes

¿El agente de Pling funciona en Raspberry Pi o servidores arm64?

Sí. Se publican binarios nativos arm64 para cada versión. El instalador detecta la arquitectura automáticamente; para instalaciones manuales, descarga pling-linux-arm64 desde la página de versiones.

¿Qué distribuciones de Linux son compatibles?

Cualquier Linux con glibc 2.17 o posterior y un sistema de init. Probado en Ubuntu, Debian, Fedora, Arch, Alpine (musl) y Raspberry Pi OS.

¿Puedo ejecutar el agente de Pling sin systemd?

Sí. Instala el binario manualmente y ejecuta pling serve bajo cualquier supervisor (runit, OpenRC, supervisord, Docker, tmux). Los subcomandos de ciclo de vida (start, stop, restart) son atajos de systemd; todo lo demás funciona sin él.

¿Dónde están los registros del agente?

Las instalaciones de systemd van a journalctl: journalctl -u pling -f, o usa pling logs -f. Las ejecuciones manuales de pling serve escriben en stdout.

¿Puedo ejecutar el agente dentro de Docker?

Sí. Monta el socket de Docker si quieres el inventario de contenedores y las acciones de inicio y parada; de lo contrario, el agente funciona perfectamente en cualquier imagen base mínima de Alpine o Debian-slim.

¿Instalando en otra plataforma? macOS · Windows