mailflow-startos
MailFlow para StartOS: cliente webmail autoadministrable que agrupa Gmail, iCloud y cualquier servidor IMAP en una interfaz unificada con notificaciones push, búsqueda en tiempo real y autenticación de inicio de sesión local.
Ficha actualizada 23 sept 2026, 6:00 · upstream 23 sept 2026, 5:45 · release v1.6.0_0
Qué es mailflow-startos
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
<p>MailFlow es un cliente webmail moderno y autoadministrable que agrupa múltiples cuentas —Gmail, iCloud, Outlook, Yahoo— en una sola interfaz limpia. Incluye composición de texto rico con selección de fuentes y tamaños, archivos adjuntos, múltiples layouts, temas oscuros y claros, notificaciones push en tiempo real, búsqueda completa sobre todo el contenido, autenticación de inicio de sesión local con certificados firmados por su propio proveedor y un panel de información.</p>
<p>El cliente se ejecuta como contenedor Docker dentro del entorno StartOS, con una arquitectura dual que soporta tanto procesadores x86_64 como aarch64 (ARM). El sistema utiliza PostgreSQL para persistencia de datos y Redis para caché, ambos gestionados por contenedores internos.</p>
<p>La configuración se realiza completamente sin interfaz gráfica: todos los parámetros se pasan mediante variables de entorno derivadas del archivo <code>store.json</code>. Esto permite un despliegue rápido y automatizado. El servicio detecta automáticamente la URL local de la red (LAN) para validar el origen WebSocket, lo que habilita notificaciones push en tiempo real.</p>
<p>El cliente soporta autenticación con OAuth de Gmail mediante claves de aplicación, pero no se configura por defecto. También es posible usar cuentas de correo con contraseña o servidores IMAP personalizados. El servicio incluye un modo de recuperación de contraseña para el administrador y permite restaurar volúmenes completos.</p>
<p>El paquete está licenciado bajo AGPL-3.0 (coincidiendo con la licencia del repositorio original), lo que permite su uso libre en proyectos open source, mientras que existen opciones comerciales disponibles para uso empresarial o propietario.</p>
- Gestionar múltiples cuentas de correo (Gmail, iCloud, Outlook) desde una sola interfaz web.
- Recibir notificaciones push en tiempo real sobre nuevas correas y mensajes.
- Búsqueda instantánea sobre todo el contenido de todas las cuentas sin necesidad de exportar datos.
- Autenticación segura mediante certificados firmados por su propio proveedor de identidad.
- Gestión completa del ciclo de vida de la cuenta: creación, configuración, recuperación y migración.
- Soporte nativo para arquitecturas x86_64 y aarch64 (ARM) en un solo paquete.
- Autenticación de inicio de sesión local con certificados firmados por su propio proveedor sin necesidad de claves externas.
- Notificaciones push en tiempo real habilitadas mediante WebSocket cuando se accede desde la red local (.local).
- Composición de texto rico con selección de fuentes, tamaños y colores, así como soporte para archivos adjuntos.
- Búsqueda completa sobre todo el contenido almacenado sin necesidad de exportar datos a un servidor externo.
- Las notificaciones push funcionan únicamente cuando se accede al cliente desde la red local (.local); en conexiones Tor o de internet claro, las notificaciones en tiempo real no son posibles debido a la validación del origen WebSocket.
- La autenticación con OAuth de Gmail no está configurada por defecto; para usarla se debe configurar manualmente una clave de aplicación (GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET) en el entorno.
- Las notificaciones push vía VAPID están desactivadas por defecto. Para activarlas, se requiere un servidor VAPID externo o la configuración del propio proveedor de correo.
- No es soportado el procesador riscv64; solo funciona con x86_64 y aarch64.
- La autenticación de inicio de sesión local no permite cambiar el proveedor de identidad (por ejemplo, de Gmail a Outlook) sin una migración manual.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
<p>Para instalar MailFlow en StartOS:</p> <ul> <li>Instale la dependencia del paquete y genere los tres secretos iniciales: SESSION_SECRET, DB_PASSWORD y ENCRYPTION_KEY.</li> <li>Configure el entorno de red con la URL local de la aplicación (APP_URL) detectada automáticamente por el servicio.</li> <li>Inicie los contenedores PostgreSQL y Redis en paralelo. El backend espera a ambos antes de iniciar, y el frontend se inicia solo después del backend.</li> <li>Acceda al panel webmail en <code><hostname>.local</code> (LAN) para usar notificaciones push; la conexión Tor o de internet claro no habilita este modo.</li> <li>Para cambiar el proveedor de identidad, use la acción "Reset Admin Password" del panel de administración.</li> <li>Para restaurar datos perdidos, haga un backup completo del volumen <code>main</code>.</li> </ul> <p>El archivo <code>store.json</code> generado al
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.