Guía de despliegue

Migrar desde Pocket: alternativas self-hosted en VPS

Desplegar en un VPS Cloud →

Tutorial

Migrar desde Pocket: alternativas self-hosted en VPS

Autoalojamiento10 min de lectura14 pasos

El cierre de Pocket en julio de 2025 puso de manifiesto un riesgo habitualmente subestimado: años de lectura organizada pueden desaparecer en pocas semanas. Karakeep y Wallabag ofrecen una alternativa duradera — dos herramientas de código abierto que despliegas en tu propio VPS en menos de dos horas, con importación nativa de tu biblioteca existente de Pocket.

Contenido· Cuando un servicio desaparece y se lleva tus datos con él1/8
  1. 01Cuando un servicio desaparece y se lleva tus datos con él
  2. 02Qué ganas al autoalojar tu lista de lectura
  3. 03Requisitos previos: qué VPS elegir
  4. 04Desplegar Karakeep en un VPS e importar tus datos de Pocket
  5. 05Desplegar Wallabag como alternativa
  6. 06Karakeep o Wallabag: comparativa
  7. 07Problemas frecuentes y soluciones
  8. 08Recuperar el control duradero de tu lectura

Cuando un servicio desaparece y se lleva tus datos con él

El 8 de julio de 2025, Pocket pasó a modo de solo lectura. Mozilla había anunciado el cierre un mes antes, alegando un cambio de prioridades estratégicas. Los usuarios tuvieron aproximadamente 90 días para exportar su biblioteca desde getpocket.com/export antes de que llegara el plazo del 12 de noviembre de 2025: ese día, Mozilla desactivó la exportación y eliminó de forma definitiva los datos de cada cuenta. Quienes no habían exportado a tiempo lo perdieron todo sin posibilidad de recuperación. Mozilla no conservó ninguna copia, y la API de Pocket está ahora fuera de línea. Omnivore, una herramienta de lectura anotada adquirida por ElevenLabs, había cerrado unos meses antes en circunstancias similares. Estos dos cierres consecutivos pusieron de manifiesto un riesgo habitualmente subestimado: diez años de marcadores, anotaciones y etiquetas organizadas pueden desaparecer en pocas semanas, sin ningún proceso de apelación.

Qué ganas al autoalojar tu lista de lectura

Alojar tu propia lista de lectura en un VPS cambia fundamentalmente la relación con tus datos. Estas son las ventajas concretas frente a un servicio en la nube como Pocket u Omnivore.

  • Permanencia de los datos — tus artículos archivados siguen accesibles mientras tu servidor funcione, independientemente de las decisiones comerciales o financieras de cualquier proveedor externo; el cierre de una startup ya no te afecta
  • Privacidad de lectura — ningún perfil publicitario se construye a partir de tus hábitos de lectura; las URLs guardadas, las etiquetas y las anotaciones no salen de tu infraestructura
  • Control total de las copias de seguridad — defines tú la frecuencia, el destino (S3, Backblaze, NAS local) y la retención de tus snapshots sin depender de un plan de pago ni de una cuota de espacio
  • Integración abierta con tu stack — la API REST de Karakeep o Wallabag se conecta con cualquier herramienta (n8n, Zapier, scripts propios, extensiones de navegador) sin coste adicional ni restricciones de volumen
  • Almacenamiento sin cuotas artificiales — el límite es tu disco; no pagas un suplemento por archivar 50 000 artículos en lugar de 1 000
  • Actualizaciones a tu ritmo — decides cuándo aplicar una versión mayor, puedes probarla en staging y revertir si una actualización introduce una regresión
  • Portabilidad permanente — tus datos viven en una base SQLite o PostgreSQL que puedes exportar, migrar o transformar en cualquier momento, sin depender de un formato propietario

Requisitos previos: qué VPS elegir

Una aplicación de lista de lectura autoalojada no es una carga de trabajo exigente. Karakeep necesita algo más de RAM que Wallabag, porque ejecuta Meilisearch para búsqueda semántica y un motor de renderizado headless (Puppeteer) para el archivado de contenido completo. La configuración mínima recomendada es un VPS con 2 GB de RAM, 1 vCPU y 20 GB de almacenamiento SSD. Para un equipo de menos de diez personas, esta configuración aguanta sin ajustes. Wallabag es aún más ligero: 512 MB de RAM bastan para uso individual. En ambos casos, los puertos 80 y 443 deben estar abiertos en el cortafuegos, Docker y Docker Compose v2 deben estar instalados, y se necesita un nombre de dominio apuntado a la IP del servidor para activar HTTPS con Let's Encrypt o Caddy.

Desplegar Karakeep en un VPS e importar tus datos de Pocket

Los pasos siguientes asumen un VPS con al menos 2 GB de RAM, Docker y Docker Compose v2 instalados, y un nombre de dominio apuntando a la IP del servidor. Todo el proceso lleva menos de 30 minutos en una instancia nueva.

  1. Localiza tu exportación de Pocket

    Si exportaste antes del 12 de noviembre de 2025, tienes un archivo llamado ril_export.html. Es un documento HTML que contiene todas tus URLs guardadas junto con sus títulos, etiquetas y estado (leído / no leído). Este archivo es tu única fuente de datos: guarda una copia en almacenamiento externo antes de empezar.

  2. Crea un directorio de trabajo en el VPS

    Conéctate por SSH y ejecuta: mkdir -p /opt/karakeep && cd /opt/karakeep. Este directorio contendrá el archivo Compose y el archivo de entorno.

  3. Descarga el archivo Compose oficial

    Obtén la definición de servicios desde el repositorio oficial: wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml. Este archivo orquesta tres servicios: la aplicación principal, Meilisearch (motor de búsqueda) y el servicio de crawl.

  4. Configura las variables de entorno

    Crea el archivo .env con los valores mínimos requeridos. Define KARAKEEP_VERSION=release para usar siempre la última versión estable. Define NEXTAUTH_SECRET con una cadena aleatoria larga (al menos 32 caracteres), MEILISEARCH_MASTER_KEY con otra cadena aleatoria, y NEXTAUTH_URL con la URL pública de tu instancia, por ejemplo https://lectura.your-domain.com. Sin un NEXTAUTH_URL correcto, los redireccionamientos de autenticación fallan.

  5. Arranca los contenedores

    Ejecuta docker compose up -d. El primer arranque descarga las imágenes (unos 500 MB) e inicializa la base de datos. Verifica que los tres servicios muestren estado running con docker compose ps. La interfaz está disponible en el puerto 3000; configura tu reverse proxy (Caddy o nginx) para servir el dominio por HTTPS antes de abrirlo al público.

  6. Crea la cuenta de administrador

    En el primer acceso, Karakeep te pide crear una cuenta. Elige una contraseña fuerte; no hay restablecimiento de contraseña por correo por defecto salvo que hayas configurado un servicio SMTP.

  7. Importa el archivo de Pocket

    En la interfaz, abre Ajustes → Importar y selecciona Pocket. Sube tu archivo ril_export.html. Karakeep lee este formato de forma nativa e importa títulos, URLs, etiquetas y estados en pocos segundos para una biblioteca de tamaño medio. El crawl del contenido completo se realiza en segundo plano: un indicador de progreso aparece en el detalle de cada artículo.

  8. Verifica la importación y configura las copias de seguridad

    Navega por la vista Todos los marcadores para confirmar que tus artículos están presentes. Luego programa un backup del volumen Docker en cron: docker run --rm -v karakeep_data:/data -v /opt/backups:/backup alpine tar czf /backup/karakeep-$(date +%Y%m%d).tar.gz /data. Mantén al menos 7 días de retención en almacenamiento remoto.

Desplegar Wallabag como alternativa

Si prefieres una herramienta más madura y ligera, Wallabag existe desde 2013 y tiene una base de usuarios consolidada. Es especialmente adecuado si necesitas apps móviles estables, integración con lectores de e-books (Kobo, Kindle) o una interfaz más austera. El despliegue con Docker sigue el mismo patrón.

  1. Crea el directorio y el archivo Compose

    Ejecuta mkdir -p /opt/wallabag && cd /opt/wallabag. Crea un docker-compose.yml basándote en la plantilla oficial disponible en hub.docker.com/_/wallabag. La configuración mínima expone el puerto 80 y monta un volumen para la base de datos SQLite.

  2. Arranca el servicio

    Ejecuta docker compose up -d. La primera inicialización tarda unos minutos mientras Wallabag crea las tablas y los assets. Sigue los logs con docker compose logs -f wallabag para confirmar que el arranque termina correctamente.

  3. Asegura la cuenta por defecto

    Accede con wallabag / wallabag y ve inmediatamente a Gestión de usuarios para cambiar la contraseña. Esta cuenta es públicamente conocida — no la expongas sin cambiarla.

  4. Activa Redis para importaciones grandes

    Sin Redis, las importaciones de varios cientos de artículos agotan el tiempo de espera de PHP. En la interfaz de administración bajo Configuración interna → Importar, activa Usar Redis. Añade un servicio Redis en tu docker-compose.yml si no está ya definido.

  5. Importa desde Pocket

    Ve a Importar → Pocket. Wallabag acepta el formato CSV de Pocket (columnas url, title, tags, time_added, status) o un archivo HTML convertido. Si solo tienes el HTML de exportación de Pocket, un script Python breve basta para extraer las URLs y escribirlas en formato CSV.

  6. Configura HTTPS y apps móviles

    Pon Wallabag detrás de un reverse proxy con HTTPS. Las apps móviles oficiales (Android) usan la URL de tu instancia y tus credenciales — funcionan en cuanto HTTPS está activo. La app iOS no es oficial; clientes de terceros como Silica o Lire soportan la API de Wallabag.

Karakeep o Wallabag: comparativa

La elección entre Karakeep y Wallabag depende principalmente de tus prioridades: archivado enriquecido frente a ligereza. La tabla a continuación resume las diferencias más importantes para el uso diario.

Desplace la tabla

CriterioKarakeepWallabag
Importación Pocket nativaHTML (`ril_export.html`)CSV de Pocket o HTML convertido
Archivado de contenidoCompleto (Puppeteer, OCR, PDF)Extracción de texto solo
BúsquedaSemántica via MeilisearchTexto completo (SQL)
Interfaz móvilApps iOS y Android oficialesAndroid oficial, iOS via clientes de terceros
Etiquetado automáticoSí, via LLM opcionalSolo manual
RAM recomendada2 GB mínimo (incluye Meilisearch)512 MB son suficientes
Madurez del proyectoReciente, comunidad activaEstable desde 2013, amplia adopción

Sea cual sea la solución elegida, programa una copia de seguridad diaria del volumen Docker hacia almacenamiento remoto (S3, Backblaze B2 o un segundo VPS). Una lista de lectura sin copias de seguridad sigue siendo vulnerable a un fallo de disco — exactamente el riesgo que tratas de eliminar al dejar un servicio en la nube. Prueba una restauración al menos una vez antes de considerar tu configuración fiable.

Problemas frecuentes y soluciones

Los errores más comunes al desplegar o usar Karakeep y Wallabag siguen patrones predecibles. Aquí están las causas y soluciones para los casos más frecuentes.

  • Puerto 3000 inaccesible desde fuera — comprueba que el contenedor esté en marcha con docker compose ps y que el cortafuegos permita el tráfico entrante; luego configura un reverse proxy en lugar de exponer el puerto 3000 directamente en la IP pública
  • Importación bloqueada al 0% o sin avanzar — con Wallabag, comprueba que Redis esté habilitado en los ajustes internos del administrador; con Karakeep, verifica que el servicio crawler muestre estado running en docker compose ps
  • Bucle de redirección hacia localhost — si Karakeep redirige en bucle, NEXTAUTH_URL en .env no coincide con la URL pública real; corrígelo, recrea el contenedor con docker compose up -d --force-recreate y limpia la caché del navegador
  • Contenido no archivado tras la importación — Karakeep usa Puppeteer para renderizar páginas; algunos sitios detectan navegadores headless y bloquean la petición. Títulos y URLs siempre se guardan; el texto completo puede faltar en sitios protegidos o de pago
  • Error 502 justo después de un reinicio — Meilisearch puede tardar entre 10 y 30 segundos en arrancar e indexar; espera y recarga. Si el error persiste, revisa docker compose logs meilisearch para identificar un posible problema de permisos en el volumen de datos

Recuperar el control duradero de tu lectura

El cierre de Pocket en julio de 2025 no es un incidente aislado. Es una señal clara sobre la vida útil de los servicios gratuitos financiados por datos o por inversores con prioridades cambiantes. Karakeep y Wallabag ofrecen una alternativa concreta: dos horas de configuración son suficientes para pasar de cero a una lista de lectura operativa en tu propio VPS, con archivado de contenido, búsqueda de texto completo y copias de seguridad automatizadas. Los comandos Docker que se muestran en esta guía son estables desde hace varias versiones y no requieren ninguna experiencia especial en administración de sistemas. Lo que despliegues hoy puede funcionar en producción cinco años sin intervención, siempre que mantengas las imágenes actualizadas y pruebes tus copias de seguridad. La diferencia con Pocket es que la decisión de cerrar ahora te pertenece solo a ti.

Tu lectura, tu servidor, tus reglas

Despliega Karakeep en un VPS de ServOrbit e importa tu biblioteca de Pocket en minutos. Acceso root, almacenamiento SSD NVMe, copias de seguridad automatizadas.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva