Instalar y configurar DevWebUI
Guía oficial verificada para instalar y configurar DevWebUI: GUI + MCP control plane para servidores de desarrollo locales. Incluye instalación en Windows/macOS/Linux, configuración de seguridad, integración con agentes AI y resolución de problemas.
Inicio rápido
DevWebUI es una herramienta open source (MIT) que combina GUI visual con MCP para gestionar servidores de desarrollo locales. Permite iniciar, detener y monitorizar procesos desde un solo panel con métricas en tiempo real.
Windows: Aplicación precompilada
Descarga:
devwebui-windows-x64.exe- Ejecutable con icono, dashboard embebido y sin ventana de consolamisc/lunarwerx-tray.exe- Launcher para bandeja del sistema (incluido en ZIP)
Configuración de actualizaciones:
Para adoptar solo releases públicos por un tiempo, configura Configuración → Actualizaciones de App → Cooldown de actualización a días: una release más joven que ese número no se ofrece ni instala.
Cualquier OS: Instalación con Bun
Prerrequisitos:
- Bun instalado en el sistema (ver guía de instalación de Bun)
- Node.js 18+ (opcional, si no usas Bun)
Comandos:
bun install
bun run dev # daemon en :4000 + GUI en http://localhost:4010Nota: En su primer lanzamiento, DevWebUI escanea automáticamente archivos .devwebui y proyectos reconocibles. Después de eso, el escaneo inicial se desactiva a menos que lo habilites en Configuración.
¿Qué obtienes?
- Control de un clic: iniciar / detener / reiniciar cualquier servidor de desarrollo con estado en vivo, CPU, memoria y logs
- Panel único por repositorio: archivo
.devwebuiagrupa cada proceso bajo un encabezado colapsable - Lanzamientos conscientes del runtime: modo automático sigue el lockfile de cada proyecto
- Rescate de conflictos de puertos: detecta puertos ocupados y los libera con un clic
- Log de errores persistente: stderr deduplicado que sobrevive reinicios
- Diseñado para agentes: 31 herramientas MCP para automatización
- Vive en tu bandeja: app de bandeja Windows ejecuta el daemon oculto
Archivos .devwebui
Un archivo pequeño por repositorio lista los servidores a ejecutar. Déjalo en el root del repo y haz clic en Añadir proyecto.
{
"name": "Connections",
"processes": [
{
"id": "main",
"name": "Main SPA",
"command": "bun run dev:main",
"autostart": true
},
{
"id": "pay",
"name": "Pay plane",
"command": "bun run dev:pay",
"port": 4020
}
]
}Campos disponibles: id, name, command, cwd, port, url, color, env, autostart, waitForPort, links, companion, compose, answers.
Integración con agentes AI (MCP)
El MCP server es un thin stdio client sobre el running daemon, para que la GUI y tus agents compartan un estado.
{
"mcpServers": {
"devwebui": {
"command": "bun",
"args": ["server/src/mcp.ts"],
"cwd": "/absolute/path/to/devwebui",
"env": { "DEVWEBUI_URL": "http://localhost:4000" }
}
}
}Lista completa de herramientas MCP: AI_GUIDE.md
Configuración de seguridad
Autenticación Local API
Por defecto, la REST API del daemon responde a cualquier llamador local que no sea una página cross-site.
Habilitar autenticación:
DEVWEBUI_REQUIRE_AUTH=1 bun run devMecanismos de Seguridad
- Archivo cookie: cada arranque escribe un secreto aleatorio a
.cookieen su directorio de datos (~/.devwebui, owner-only) y lo borra al salir - Pairing de navegador: la GUI muestra una pantalla de pairing. Haz clic en Obtener código de pairing, luego escribe el código de 6 dígitos que imprime el daemon
- Token de sesión: el tray mantiene su token de sesión y sigue funcionando con reinicios/salidas
Códigos de pairing
- Códigos expiran después de 5 minutos
- Diez intentos incorrectos bloquean el pairing por 15 minutos
- CLI y MCP no se ven afectados
Comandos CLI para pairing:
devwebui pairing codes
devwebui pairing clients
devwebui pairing revoke <id>Comandos CLI
Un thin client sobre la misma REST API que la GUI y MCP usa.
devwebui start | stop | status | list # boot / stop the daemon, inspect state
devwebui start-process | stop-process | restart-process <id|name>
devwebui start-all | stop-all
devwebui open <folder|file.devwebui> # add/drop a project
devwebui alerts list | add | remove | events | clear
devwebui mcp # the stdio MCP server for agentsBackup, actualización y rollback
Backup
DevWebUI guarda su estado en ~/.devwebui. Para backup:
# Backup completo
tar -czf devwebui-backup-$(date +%Y%m%d).tar.gz ~/.devwebui
# O copia manualmente
cp -r ~/.devwebui /ruta/backup/devwebui/
Rollback
Para rollback a una versión anterior:
# 1. Backup actual
tar -czf devwebui-backup-$(date +%Y%m%d).tar.gz ~/.devwebui
# 2. Descargar release anterior desde Releases
wget https://github.com/LunarWerxs/DevWebUI/releases/download/v0.8.0/devwebui-windows-x64.exe
# 3. Restaurar backup si es necesario
tar -xzf devwebui-backup-*.tar.gz ~/.devwebui
Errores habituales y soluciones
Puerto ocupado
Síntoma: "Address already in use" al iniciar DevWebUI
Solución:
# Ver qué usa el puerto
netstat -ano | findstr :4000
# O usa un puerto diferente (se asigna automáticamente)
DEVWEBUI_PORT=4001 bun run devPairing falla
Síntoma: No puedes emparejar el navegador con la GUI
Solución:
# Verificar que el daemon está corriendo
devwebui status
# Obtener nuevo código de pairing
devwebui pairing codes
# Si tienes muchos intentos fallidos, espera 15 minutos o reinicia
devwebui stop-all
devwebui startMCP no funciona
Síntoma: Agentes AI no pueden controlar DevWebUI
Solución:
{
"mcpServers": {
"devwebui": {
"command": "bun",
"args": ["server/src/mcp.ts"],
"cwd": "/absolute/path/to/devwebui",
"env": {
"DEVWEBUI_URL": "http://localhost:4000",
"DEVWEBUI_REQUIRE_AUTH": "0" // Desactivar auth para MCP
}
}
}
}FAQ
¿Es gratuito?
Sí, MIT License. Sin suscripciones ni límites.
¿Necesita cuenta/nube?
No para funcionalidad core. Opcional: sync entre máquinas con cuenta LunarWerx Connections.
¿Pueden controlar AI agents?
Sí, 31 tools MCP para automatización.
¿Qué es un archivo .devwebui?
Un archivo pequeño por repositorio lista los servidores a ejecutar. Déjalo en el root del repo y haz clic en Añadir proyecto.
¿Maneja conflictos de puertos?
Sí. Detecta choques en un puerto, indica qué proceso lo mantiene y lo libera con un clic.
¿Funciona offline?
Sí. El daemon y GUI ejecutan completamente en localhost; funcionalidad core necesita ninguna cuenta, ninguna nube y ninguna conexión a internet.
Alternativas
- PM2: CLI gratuito, dashboard web pagado (~$39/mes). DevWebUI es gratuito, empaquetado y añade MCP.
- hotel: Browser-based, compatible con Procfile/Compose. DevWebUI añade métricas en vivo, deduplicación de errores, detección de conflictos de puertos y 31 herramientas MCP.
- exo: Browser-based, compatible con Procfile/Compose. DevWebUI agrupa servidores por repositorio y envía los mismos controles sobre MCP.