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

Arquitectura local-first con sincronización offline-first, cifrado extremo a extremo opcional y un único binario Go que incluye la PWA React, todo en menos de 50 MB y compatible con Raspberry Pi.

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.

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

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.

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

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.

# Linux/macOS/Windows descargar release desde https://github.com/OpenTodoApp/OpenTodo/releases/latest ./opentodo-linux-amd64 # O compilar desde fuente: make build && ./bin/opentodo

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.

# URL pública (cookies seguras, passkeys) OPENTODO_BASE_URL=https://todo.ejemplo.com # Registro abierto tras el primer usuario OPENTODO_ALLOW_SIGNUP=false # Token de setup (16+ chars) o código único en logs OPENTODO_SETUP_TOKEN= OPENTODO_SETUP_CODE=required # Bind seguro detrás de proxy inverso local OPENTODO_BIND=127.0.0.1 # Log level OPENTODO_LOG_LEVEL=info # Límites de importación y papelera OPENTODO_IMPORT_MAX_MB=20 OPENTODO_TRASH_RETENTION_DAYS=30 # Push web (on/off) OPENTODO_PUSH=on # CalDAV y MCP (off por defecto, activables en UI) OPENTODO_CALDAV=true OPENTODO_MCP=true # SSO OIDC (bloquea campos en UI si se definen) OPENTODO_OIDC_ISSUER=https://sso.ejemplo.com/realms/home OPENTODO_OIDC_CLIENT_ID=opentodo OPENTODO_OIDC_CLIENT_SECRET=*** # Email a tarea (IMAP) OPENTODO_EMAIL_ADDRESS=tarea@ejemplo.com OPENTODO_EMAIL_IMAP_HOST=imap.ejemplo.com:993 OPENTODO_EMAIL_IMAP_USER=tarea@ejemplo.com OPENTODO_EMAIL_IMAP_PASSWORD_FILE=/run/secrets/imap_pass # Backups programados (presets de primer arranque) OPENTODO_BACKUP_DESTINATION=s3 OPENTODO_BACKUP_SCHEDULE=daily OPENTODO_BACKUP_TIME=03:00 OPENTODO_BACKUP_KEEP=7 OPENTODO_BACKUP_S3_ENDPOINT=https://s3.eu-central-1.amazonaws.com OPENTODO_BACKUP_S3_BUCKET=mi-bucket OPENTODO_BACKUP_S3_ACCESS_KEY=*** OPENTODO_BACKUP_S3_SECRET_KEY=*** OPENTODO_BACKUP_PASSPHRASE_FILE=/run/secrets/backup_pass

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.

OPENTODO_HOST_URL=https://mi-servicio.com OPENTODO_HOST_TOKEN=clave-larga-32-chars-minimo OPENTODO_HOST_OPERATOR_ADDR=127.0.0.1:8081 OPENTODO_HOST_IDLE_MINUTES=10 OPENTODO_HOST_MAX_OPEN=500 OPENTODO_HOST_LIMITS=db_mb=500,ops_per_hour=5000,members=10

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

OPENTODO_DEMO=true OPENTODO_DEMO_MAX_SANDBOXES=100 OPENTODO_DEMO_MAX_DB_MB=50

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

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.

# Ejemplo backup local diario cifrado OPENTODO_BACKUP_DESTINATION=local OPENTODO_BACKUP_LOCAL_DIR=/backups OPENTODO_BACKUP_SCHEDULE=daily OPENTODO_BACKUP_TIME=03:00 OPENTODO_BACKUP_KEEP=14 OPENTODO_BACKUP_COMPRESS=true OPENTODO_BACKUP_PASSPHRASE_FILE=/run/secrets/backup_pass

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

docker compose ps # Healthcheck manual docker exec <container> /opentodo healthcheck

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

# Ejemplos ot --server https://todo.ejemplo.com --token $TOKEN user list ot --server https://todo.ejemplo.com --token $TOKEN project create "Nuevo proyecto" ot backup create --destination s3

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

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