OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción
OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción
Tu servidor, tus tareas. Un gestor de tareas open source que puedes alojar tú mismo con soporte offline, cifrado extremo a extremo y sincronización multiplataforma.
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 diseñada para ejecutarse en tu propio servidor. Ofrece todas las funciones que se esperan de una aplicación comercial de tareas —captura en lenguaje natural, planificación diaria y semanal, temporizadores Pomodoro, proyectos compartidos— sin suscripciones, sin bloqueo de proveedor y sin telemetría. Los datos residen en una única carpeta del servidor (SQLite), se pueden exportar e importar libremente y la sincronización funciona en segundo plano incluso sin conexión gracias a su arquitectura local-first basada en operaciones por campo con reloj lógico híbrido.
Características principales
Captura en lenguaje natural
Escribe tareas como las dices: "Llamar a Sara el miércoles 15h #trabajo p1" y OpenTodo extrae fecha, hora, proyecto y prioridad. Soporta dictado, extensión de navegador (Chrome, Firefox), menú compartir del móvil y reenvío de correo.
Planificación visual con bloqueo de tiempo
Vista Hoy con tareas vencidas y pendientes, estimaciones de duración y arrastre a calendario día/semana para ver si el día cabe. Incluye vista Kanban por proyecto.
Modo Foco con temporizadores
Abre una tarea en Foco y arranca Pomodoro, Flowtime o cuenta atrás. El tiempo se registra en la propia tarea.
Proyectos compartidos con roles
Comparte proyectos con familia o equipo como visor, editor o admin. Asignación de tareas, comentarios, historial de cambios y edición offline simultánea.
Datos tuyos, portables y con copias de seguridad
Todo en una carpeta (SQLite). Exportación/importación completa, copias programadas a disco, S3 o WebDAV con cifrado opcional. Sin telemetría, sin analíticas, sin fuentes de terceros.
Funciona offline en todos los dispositivos
Cada dispositivo mantiene una copia completa (IndexedDB). La app funciona sin conexión y sincroniza al reconectar. Instalable como PWA en iOS, Android y escritorio.
Importación desde otras apps
Importa desde Todoist, TickTick, Things, Super Productivity, Microsoft To Do, Apple Reminders y más, con vista previa y deshacer.
IA opcional y bajo tu control
Asistente integrado o trae tu propio proveedor (MCP). Desactivado por defecto, cada cambio reversible.
CalDAV y webhooks
Endpoint CalDAV para apps de calendario y webhooks salientes para integraciones (n8n, Home Assistant, etc.).
API REST documentada y CLI
OpenAPI 3.1 en /api/v1/openapi.json, cliente CLI `ot`, plugin Obsidian y nodos n8n oficiales.
Requisitos del sistema
- Docker y Docker Compose (recomendado)
- Go 1.26+ y Node 22+ para compilar desde fuente
- Arquitecturas linux/amd64 y linux/arm64 (Raspberry Pi compatible)
- Volumen persistente para /data (SQLite y assets)
- Puerto 8080 TCP (configurable via OPENTODO_PORT)
Instalación con Docker Compose
Docker Compose (recomendado)
Clona el repositorio y levanta el contenedor. Los datos persisten en el volumen `opentodo-data`. La primera visita a la UI crea la cuenta de propietario.
Docker run rápido
Una sola línea para probar o desplegar sin clonar. El volumen `opentodo-data` guarda la base de datos y archivos.
Binario único (sin contenedor)
Descarga el binario `opentodo-<os>-<arch>` del último release de GitHub y ejecútalo. Sirve en puerto 8080 y guarda datos en ./data.
Acceder al proyecto
Interfaz web
Abre http://localhost:8080 (o el host/puerto configurado). La primera visita crea la cuenta de propietario. Si el servidor es accesible desde internet, configura `OPENTODO_SETUP_CODE=required` o `OPENTODO_SETUP_TOKEN` para proteger el registro inicial.
Aplicaciones móviles
iOS: App Store (OpenTodo). Android: APK desde GitHub Releases (Google Play y F-Droid en camino). Ambas conectan a tu servidor mediante URL y credenciales.
PWA instalable
Desde el navegador en escritorio o móvil: menú → Instalar. Funciona offline completo gracias a IndexedDB y service worker firmado.
Casos de uso
- Gestión personal de tareas con captura rápida y planificación diaria
- Equipos y familias que necesitan listas compartidas con roles y edición offline
- Usuarios que buscan alternativa a Todoist/TickTick/Things sin suscripción ni lock-in
- Entornos con conectividad intermitente (viajes, campo, oficina sin wifi fiable)
- Autohospedaje en NAS, Raspberry Pi, VPS o plataformas como Umbrel, Unraid, Home Assistant, Kubernetes
- Integración con calendarios vía CalDAV y automatizaciones vía webhooks/MCP/n8n
- Migración desde otras apps con importación asistida y deshacer
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 de Coolify/Portainer.
Modo multi-tenant (hosted service)
Un proceso sirve múltiples inquilinos por hostname. Requiere `OPENTODO_HOST_URL`, `OPENTODO_HOST_TOKEN` (32+ chars) y puerto operador `OPENTODO_HOST_OPERATOR_ADDR` (defecto 127.0.0.1:8081). Límites por defecto: 500 tenants abiertos, 10 min idle, 500 MB DB, 5000 ops/hora, 10 miembros.
Instancia demo pública
Activa `OPENTODO_DEMO=true` en un volumen de datos dedicado y vacío. Crea cuenta demo compartida, resiembra cada noche a las 03:00 UTC, bloquea registro, integraciones y cambios de cuenta. Variables de control: `OPENTODO_DEMO_MAX_SANDBOXES`, `OPENTODO_DEMO_MAX_DB_MB`.
Gestión y mantenimiento
Actualizaciones
Etiquetas de imagen: `:stable` (último release), `:1` (línea 1.x), `:1.5` (solo fixes 1.5), `:1.5.0` (pin exacto), `:latest` (rama main). Actualizaciones desde 0.1.0 funcionan directo; compatibilidad garantizada dentro de 1.x. Con Docker Compose: `docker compose pull && docker compose up -d`.
Copias de seguridad
Configurables en UI (Ajustes → Backups) o via variables de entorno (presets de primer arranque). Destinos: local (directorio), S3 (compatible S3), WebDAV. Cifrado con passphrase (archivo o variable). Programación: off, hourly, daily, weekly. Retención por cuenta (`_KEEP`, `_MAX_AGE_DAYS`) y compresión opcional.
Healthcheck y monitorización
El contenedor expone healthcheck nativo (`/opentodo healthcheck`) cada 30s. Puerto 8080. Logs en stdout (nivel configurable). Métricas y auditoría: el log de auditoría nunca registra contenido de tareas (ver SECURITY.md).
CLI de administración (`ot`)
Cliente oficial para automatizar: usuarios, proyectos, tareas, tokens API, backups, migraciones. Documentado en docs/cli.md. Autenticación con token API (Ajustes → Integraciones → API tokens).
Stack técnico
- Go 1.27 (binario único, CGO_ENABLED=0, distroless static-debian12 nonroot)
- React 18 + TypeScript (PWA, Vite, service worker firmado)
- SQLite (base de datos embebida, un archivo)
- IndexedDB (fuente de verdad en cliente, sync offline-first)
- Hybrid Logical Clock + device ID para resolución de conflictos por campo
- OpenAPI 3.1 generado desde código (estable en 1.x)
- CalDAV (RFC 4791), Web Push (VAPID), IMAP (email a tarea)
- MCP (Model Context Protocol) para asistentes IA
- Docker multi-arch (linux/amd64, linux/arm64), imagen < 50 MB
Referencias oficiales
- Repositorio GitHub: https://github.com/OpenTodoApp/OpenTodo
- Sitio web y documentación oficial: https://open-todo.app/docs/
- Demo online (copia privada 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 autohospedaje (Docker, Umbrel, Unraid, HA, K8s): https://open-todo.app/docs/self-hosting/README.md
- Referencia de configuración (variables de entorno): https://open-todo.app/docs/self-hosting/configuration.md
- API REST y OpenAPI: https://open-todo.app/docs/api.md
- CLI `ot`: https://open-todo.app/docs/cli.md
- Comunidad Discord: https://discord.gg/mmSsuCRduD
Comentarios
Publicar un comentario