OpenTodo: Gestor de tareas autoalojado, local-first y sin suscripción

Open Source · Self-hosted · AGPL-3.0

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.

Arquitectura local-first con sincronización por operaciones de campo, base de datos SQLite única y binario Go que incluye la PWA React integrada; funciona en Raspberry Pi y consume ~20 MB en reposo.

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.

git clone https://github.com/OpenTodoApp/OpenTodo.git cd OpenTodo docker compose up -d

Docker run rápido (prueba local)

Un solo contenedor con volumen nombrado. Sirve en puerto 8080 sin configuración adicional.

docker run -d -p 8080:8080 -v opentodo-data:/data ghcr.io/opentodoapp/opentodo:stable

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.

# Ejemplo Linux amd64 wget https://github.com/OpenTodoApp/OpenTodo/releases/latest/download/opentodo-linux-amd64 chmod +x opentodo-linux-amd64 ./opentodo-linux-amd64

Compilar desde fuente

Requiere Go 1.26+ y Node 22+. Genera el binario en ./bin/opentodo con la PWA embebida.

make build ./bin/opentodo

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.).

# URL pública para cookies seguras y comprobación Origin OPENTODO_BASE_URL=https://todo.ejemplo.com # Publicar solo en localhost detrás de proxy OPENTODO_BIND=127.0.0.1 # Registro abierto tras la primera cuenta (propietario) OPENTODO_ALLOW_SIGNUP=false # Token de 16+ chars para primera cuenta (opcional) OPENTODO_SETUP_TOKEN= # Código de configuración único desde logs (required/off) OPENTODO_SETUP_CODE= # Nivel de log: debug, info, warn, error OPENTODO_LOG_LEVEL=info # Límites de importación (MB) OPENTODO_IMPORT_MAX_MB=20 # Días de retención en papelera (0 = manual) OPENTODO_TRASH_RETENTION_DAYS=30 # Push web (on/off) OPENTODO_PUSH=on # CalDAV y MCP (true/false, off por defecto) OPENTODO_CALDAV=false OPENTODO_MCP=false # SSO OIDC (bloquea campos en Ajustes si se definen) OPENTODO_OIDC_ISSUER= OPENTODO_OIDC_CLIENT_ID= OPENTODO_OIDC_CLIENT_SECRET= OPENTODO_OIDC_DISPLAY_NAME= OPENTODO_OIDC_SSO_ONLY= # Email a tarea (IMAP) OPENTODO_EMAIL_ADDRESS= OPENTODO_EMAIL_IMAP_HOST= OPENTODO_EMAIL_IMAP_USER= OPENTODO_EMAIL_IMAP_PASSWORD= OPENTODO_EMAIL_IMAP_MAILBOX=INBOX OPENTODO_EMAIL_POLL_SECONDS=60 OPENTODO_EMAIL_PROCESSED=move:OpenTodo/Processed # Backups programados (preajustes de primer arranque) OPENTODO_BACKUP_DESTINATION=local OPENTODO_BACKUP_SCHEDULE=daily OPENTODO_BACKUP_TIME=03:00 OPENTODO_BACKUP_KEEP=7 OPENTODO_BACKUP_PASSPHRASE_FILE=/run/secrets/opentodo_backup_passphrase

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.

docker compose pull docker compose up -d

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).

docker compose logs -f opentodo

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

Apoya el canal GENBYTE

Sígueme en mis redes sociales

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Solución al Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable