OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción
OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción
Tu lista de tareas, tu servidor. Una alternativa open source a Todoist que funciona offline, cifra tus datos y no te ata a ninguna nube.
Vídeo tutorial en YouTube
Mira el vídeo completo sobre cómo instalar y usar OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción en el canal GENBYTE:
¿Qué es OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción?
OpenTodo es una aplicación de tareas de código abierto que ejecutas en tu propio servidor o en una instancia alojada. Está diseñada para funcionar local-first: cada dispositivo mantiene una copia completa de los datos, permitiendo trabajar sin conexión y sincronizando cuando se restablece la conectividad. No requiere suscripción, no incluye telemetría ni scripts de terceros, y ofrece cifrado de extremo a extremo opcional para que el servidor solo almacene texto cifrado. El proyecto está licenciado bajo AGPL-3.0 y su código reside en GitHub bajo la organización OpenTodoApp.
Características principales
Captura en lenguaje natural
Escribe tareas como las dices: "Llamar a Sara el miércoles que viene a las 3pm #trabajo p1" y OpenTodo extrae fecha, hora, proyecto y prioridad. Soporta dictado, menú compartir del móvil, extensiones de navegador (Chrome, Firefox) y reenvío de correo.
Planificación visual con bloqueo de tiempo
Vista Today con tareas vencidas y pendientes, estimaciones de duración y arrastre a calendario día/semana para ver si el día cabe. Incluye modo foco con temporizadores Pomodoro, Flowtime o cuenta atrás que registran el tiempo en la tarea.
Proyectos compartidos con roles
Comparte proyectos con familia o equipo como visor, editor o administrador. Permite asignar tareas, comentar y ver historial de cambios. Todos los miembros pueden editar offline y los cambios se fusionan campo a campo al sincronizar.
Datos tuyos, portables y con copias de seguridad
Todo vive en una carpeta del servidor. Exporta e importa en cualquier momento, programa copias cifradas a disco local, S3 o WebDAV. Soporta importación desde Todoist, TickTick, Things, Super Productivity, Microsoft To Do, Apple Reminders y más, con vista previa y deshacer.
Privacidad por defecto y cifrado opcional
Sin analíticas, crash reporters, pings de actualización ni fuentes de terceros. Mapas y push web activados por defecto y desactivables. El cifrado de extremo a extremo hace que el servidor solo guarde texto cifrado; el registro de auditoría nunca almacena contenido de tareas.
IA opcional y extensible
Asistente integrado en la app o conecta tu propio proveedor. Desactivado por defecto y cada cambio es reversible. Expone API REST, OpenAPI 3.1, CalDAV, webhooks, MCP y CLI para construir clientes propios.
Multiplataforma nativa
PWA instalable en cualquier navegador, app nativa en App Store (iOS/iPadOS) y APK para Android (Google Play y F-Droid en camino). Funciona en 20 plataformas de autoalojamiento documentadas: Docker, Umbrel, Unraid, Home Assistant, Kubernetes/Helm, PikaPods, Coolify, binario único, etc.
Requisitos del sistema
- Docker y Docker Compose (recomendado)
- Go 1.26+ y Node 22+ para compilar desde fuente
- Arquitecturas linux/amd64 y linux/arm64 (imagen multiarch)
- Volumen persistente para /data (SQLite + assets)
- Puerto 8080 TCP expuesto (configurable via OPENTODO_PORT)
Instalación con Docker Compose
Docker Compose (recomendado para producción)
Clona el repositorio, levanta la pila y accede a http://localhost:8080. La primera visita crea la cuenta de propietario. Los datos persisten en el volumen opentodo-data. Detrás de proxy inverso, define OPENTODO_BASE_URL=https://todo.ejemplo.com y OPENTODO_BIND=127.0.0.1 en .env.
Docker run rápido (prueba local)
Un solo contenedor con volumen nombrado. Sirve en puerto 8080 sin configuración adicional.
Binario único (Linux, macOS, Windows)
Descarga el artefacto opentodo-<os>-<arch> del último release de GitHub, dale permisos de ejecución y ejecútalo. Sirve en 8080 y guarda datos en ./data.
Compilar desde fuente
Requiere Go 1.26+ y Node 22+. Genera el binario en ./bin/opentodo con la PWA embebida.
Acceder al proyecto
Interfaz web
Abre http://localhost:8080 (o la URL configurada en OPENTODO_BASE_URL). El primer acceso muestra el asistente de creación de la cuenta de propietario; no hay usuario ni contraseña por defecto.
Aplicaciones móviles
iOS/iPadOS: descarga desde App Store (ID 6832200428). Android: APK desde GitHub Releases. Ambas se conectan a tu servidor introduciendo su URL y credenciales.
API REST y OpenAPI
Documentación en /api/v1/openapi.json (OpenAPI 3.1). Autenticación con token de API desde Ajustes → Integraciones → Tokens de API. Clientes de referencia: CLI ot, plugin Obsidian, nodos n8n.
Casos de uso
- Gestión personal de tareas con captura rápida, planificación diaria y modo foco.
- Listas compartidas en familia: compras, quehaceres, recordatorios con roles de edición.
- Equipos pequeños: proyectos colaborativos, asignación, comentarios, trabajo offline y sincronización al reconectar.
- Migración desde Todoist, TickTick, Things, Super Productivity, Microsoft To Do o Apple Reminders con importación asistida.
- Automatización via webhooks, CalDAV, email-a-tarea (IMAP) y MCP para asistentes de IA.
- Entornos con requisitos de soberanía de datos: sin telemetría, cifrado E2EE opcional, backups cifrados programados.
Configuración avanzada
Variables de entorno principales
Todas son opcionales con valores por defecto seguros. Se definen en .env junto a docker-compose.yml o en la UI del proveedor (Coolify, etc.).
Copias de seguridad cifradas
Destinos: local (directorio), S3 (compatible), WebDAV. Cifrado con frase de paso (OPENTODO_BACKUP_PASSPHRASE o archivo). Programación: off, hourly, daily, weekly. Retención por cuenta (keep) y edad máxima (max_age_days). Compresión opcional. La UI en Ajustes → Backups prevalece sobre variables tras el primer arranque.
Modo multi-inquilino (host mode)
Un proceso sirve múltiples inquilinos por nombre de host. Requiere OPENTODO_HOST_URL, OPENTODO_HOST_TOKEN (32+ chars) y OPENTODO_HOST_OPERATOR_ADDR (default 127.0.0.1:8081). Límites por defecto: 500 inquilinos abiertos, 10 min idle, 500 MB BD, 5000 ops/hora, 10 miembros. Documentado en docs/self-hosting/host-mode.md.
Healthcheck y actualizaciones
El contenedor incluye healthcheck CMD ["/opentodo", "healthcheck"] cada 30s. Etiquetas de imagen: :stable (último release), :1 (línea 1.x), :1.5 (menor), :1.5.0 (fijo), :latest (rama main). Actualizaciones desde 0.1.0 funcionan directo; estabilidad 1.x documentada en docs/stability.md.
Gestión y mantenimiento
Actualizar versión
Con Docker Compose: pull de la nueva etiqueta y recreate. Los datos persisten en el volumen opentodo-data. Migraciones de BD automáticas al arranque.
Backup manual y restauración
Desde la UI: Ajustes → Backups → Crear backup ahora. Descarga el archivo .zip.crypt (si cifrado) o .zip. Para restaurar: misma pantalla → Restaurar desde archivo. También programable via variables de entorno o CLI ot backup.
Logs y depuración
Nivel de log configurable (OPENTODO_LOG_LEVEL). Salida stdout/stderr del contenedor. Healthcheck expone estado en /healthz. Auditoría de seguridad en SECURITY.md (qué se registra: nunca contenido de tareas).
Gestión de usuarios
Mantén OPENTODO_ALLOW_SIGNUP=false y envía enlaces de invitación desde Ajustes → Miembros. El propietario puede promover/revocar roles (visor, editor, admin). CLI ot user para operaciones en lote.
Stack técnico
- Go 1.27 (binario único, SQLite embebido)
- React 18 + TypeScript (PWA, Vite)
- IndexedDB en cliente (fuente de verdad local)
- Sincronización por operaciones de campo con reloj lógico híbrido
- SQLite (WAL) en servidor, archivo único en /data
- Distroless static-debian12 nonroot (imagen <50 MB)
- OpenAPI 3.1 generado desde código (estable en 1.x)
- CalDAV, Webhooks, MCP, IMAP, S3, WebDAV
Referencias oficiales
- Repositorio GitHub: https://github.com/OpenTodoApp/OpenTodo
- Sitio web y documentación: https://open-todo.app/docs/
- Demo online (copia temporal): https://demo.open-todo.app
- Releases y binarios: https://github.com/OpenTodoApp/OpenTodo/releases/latest
- Docker Hub / GHCR: https://github.com/OpenTodoApp/OpenTodo/pkgs/container/opentodo
- Guía de autoalojamiento (20 plataformas): https://github.com/OpenTodoApp/OpenTodo/tree/main/docs/self-hosting
- Referencia de configuración: https://github.com/OpenTodoApp/OpenTodo/blob/main/docs/self-hosting/configuration.md
- API REST y OpenAPI: https://github.com/OpenTodoApp/OpenTodo/blob/main/docs/api.md
- Comunidad Discord: https://discord.gg/mmSsuCRduD
- Licencia AGPL-3.0: https://github.com/OpenTodoApp/OpenTodo/blob/main/LICENSE
Comentarios
Publicar un comentario