Documentación de Rud1
Todo lo que necesitas para conectar, gestionar y monitorizar tus dispositivos IoT desde cualquier lugar.
¿Qué es Rud1?
Rud1 es una plataforma IoT que te permite gestionar flotas de dispositivos de forma remota, segura y sin necesidad de IPs públicas. La plataforma se compone de tres componentes principales:
rud1-es
El SaaS en la nube. Dashboard web para gestionar dispositivos, usuarios, alertas, firmware y VPN. Alojado en rud1.es.
rud1-fw
El agente de firmware que se instala en la Raspberry Pi. Envía métricas, gestiona la VPN WireGuard y aplica actualizaciones OTA.
rud1-app
El panel web local servido desde el propio dispositivo. Accesible en la red local sin necesidad de internet.
Arquitectura
Los tres componentes se comunican de la siguiente forma:
┌─────────────────────────────────────────────────────┐
│ rud1.es (nube) │
│ Dashboard · API REST · Gestión firmware · Alertas │
└────────────────────┬────────────────────────────────┘
│ HTTPS (heartbeat, logs, firmware)
│
┌────────────────────▼────────────────────────────────┐
│ Raspberry Pi (dispositivo) │
│ │
│ rud1-fw (agente) rud1-app (panel local) │
│ Puerto: 7070 ◄──────── Puerto: 80 │
│ Servicio systemd Servido con nginx │
│ │
│ WireGuard (wg0) ◄── Configurado por rud1-es │
└─────────────────────────────────────────────────────┘
│ WireGuard UDP :51820
│
┌────────────────────▼────────────────────────────────┐
│ Servidor VPN WireGuard (hub) │
│ VPS propio o servicio gestionado │
└─────────────────────────────────────────────────────┘
Requisitos previos
Para empezar a usar Rud1 necesitas:
- ✓Raspberry Pi 3B+, 4 o 5 (u otro dispositivo Linux ARM64 o AMD64)
- ✓Conexión a internet en el dispositivo durante la configuración
- ✓Una cuenta gratuita en rud1.es
- ✓Acceso SSH o teclado + pantalla en el dispositivo
- ✓Opcional: servidor VPN WireGuard para conectividad remota
💡 Si solo quieres explorar la plataforma, puedes registrarte en rud1.es y navegar el dashboard sin necesidad de un dispositivo físico.
Secciones de la documentación
Comenzar
Crea tu cuenta, invita a tu equipo y conecta tu primer dispositivo.
Configurar dispositivo
Instala el agente rud1-fw en una Raspberry Pi y regístrala en la plataforma.
Referencia de configuración
Referencia completa de config.yaml y variables de entorno.
Panel local
Accede al panel web de rud1-app servido directamente desde el dispositivo.
VPN & WireGuard
Arquitectura VPN, configuración del servidor y resolución de problemas.
Gestión de firmware
Actualiza dispositivos OTA: compila, sube, crea rollouts y haz rollback.
API Reference
Endpoints M2M del agente, autenticación y API local del dispositivo.
FAQ & Solución de problemas
Respuestas a las preguntas más frecuentes sobre instalación, VPN, firmware y más.
¿Necesitas ayuda?
Si no encuentras lo que buscas en la documentación, puedes contactar con nuestro equipo de soporte en support@rud1.es.