Hoarder Docker Compose: Gestor De Marcadores Con IA 2025

Si acumulas cientos de marcadores sin organizar, capturas de pantalla perdidas y notas dispersas en diferentes aplicaciones, Hoarder Docker Compose es la solución definitiva para centralizar todo tu contenido digital. Esta herramienta con inteligencia artificial etiqueta automáticamente enlaces, notas e imágenes, permitiéndote encontrar cualquier cosa al instante mediante búsqueda de texto completo.

¿Qué es Hoarder Docker Compose?

Hoarder Docker Compose (ahora renombrado como Karakeep) es una aplicación self-hosted de código abierto diseñada para gestionar marcadores, notas, imágenes y documentos PDF en un solo lugar. A diferencia de soluciones comerciales como Pocket o Raindrop, esta alternativa te da control total sobre tus datos mientras aprovecha inteligencia artificial para organizar automáticamente tu contenido.

El proyecto cuenta con más de 21,700 estrellas en GitHub, lo que demuestra su popularidad en la comunidad de self-hosting. La aplicación utiliza tecnologías modernas como NextJS, Drizzle ORM y Meilisearch para ofrecer una experiencia fluida y rápida.

Características principales de Hoarder Docker Compose

Esta plataforma destaca por combinar funcionalidades tradicionales de gestión de marcadores con capacidades avanzadas de inteligencia artificial:

Etiquetado automático con IA: El sistema analiza tu contenido y asigna etiquetas relevantes usando OpenAI o modelos locales con Ollama
Búsqueda de texto completo: Encuentra cualquier marcador, nota o documento mediante palabras clave instantáneamente
OCR integrado: Extrae texto de imágenes y documentos escaneados para hacerlos buscables
Múltiples tipos de contenido: Guarda enlaces web, notas de texto, imágenes y archivos PDF
Metadata automática: Captura títulos, descripciones e imágenes de los enlaces automáticamente
Aplicaciones móviles: Disponible para iOS y Android con sincronización en tiempo real
Extensiones de navegador: Compatible con Chrome y Firefox para guardar contenido rápidamente
API REST: Integra con otras herramientas mediante endpoints documentados
Feeds RSS: Automatiza la captura de contenido de tus fuentes favoritas
Archivo de páginas web: Guarda versiones completas de sitios web para consulta offline

Instalación de Hoarder Docker Compose paso a paso

El proceso de instalación es sencillo y solo requiere Docker y Docker Compose en tu servidor. Sigue estos pasos para tener Hoarder Docker Compose funcionando en minutos:

Paso 1: Crear directorio de trabajo

Primero crea un directorio dedicado para alojar los archivos de configuración:

mkdir ~/hoarder-app
cd ~/hoarder-app

Paso 2: Descargar docker-compose.yml

Descarga el archivo de configuración oficial desde el repositorio de GitHub:

wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

Paso 3: Configurar variables de entorno

Crea un archivo .env con las credenciales y configuración necesarias. Genera strings aleatorios seguros usando:

openssl rand -base64 36

Luego crea el archivo .env con este contenido mínimo:

KARAKEEP_VERSION=release
NEXTAUTH_SECRET=tu_string_aleatorio_generado
MEILI_MASTER_KEY=otro_string_aleatorio_diferente
NEXTAUTH_URL=http://tu-servidor.com:3000

Cambia tu-servidor.com por la dirección IP o dominio de tu servidor. Si deseas habilitar el etiquetado automático con IA, añade tu clave de OpenAI:

OPENAI_API_KEY=sk-tu-clave-api-de-openai

Paso 4: Alternativa con Ollama (IA local)

Si prefieres usar modelos de IA locales en lugar de OpenAI, configura Ollama añadiendo estas variables al archivo .env:

OLLAMA_BASE_URL=http://localhost:11434
INFERENCE_TEXT_MODEL=llama3.1
INFERENCE_IMAGE_MODEL=llava
INFERENCE_CONTEXT_LENGTH=8000

Esta configuración permite que el sistema funcione completamente offline sin depender de servicios externos. Si aún no tienes Ollama instalado, consulta nuestra guía completa.

Paso 5: Iniciar los contenedores

Una vez configurado, levanta todos los servicios con un solo comando:

docker compose up -d

El sistema descargará las imágenes necesarias y arrancará tres contenedores: la aplicación web, la base de datos PostgreSQL y el motor de búsqueda Meilisearch.

Paso 6: Acceder a la interfaz web

Abre tu navegador y accede a http://tu-servidor:3000. En la primera visita deberás crear tu cuenta de administrador con un correo electrónico y contraseña.

Archivo docker-compose.yml completo para Hoarder

Si prefieres personalizar la configuración, aquí tienes un ejemplo completo del archivo docker-compose.yml optimizado:

version: "3.8"

services:
  web:
    image: ghcr.io/karakeep-app/karakeep:${KARAKEEP_VERSION:-release}
    restart: unless-stopped
    volumes:
      - data:/data
    ports:
      - "3000:3000"
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      DATA_DIR: /data
      NEXTAUTH_URL: ${NEXTAUTH_URL}
      NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
      OPENAI_API_KEY: ${OPENAI_API_KEY}
    depends_on:
      - meilisearch
      - db

  meilisearch:
    image: getmeili/meilisearch:v1.10
    restart: unless-stopped
    env_file:
      - .env
    environment:
      MEILI_NO_ANALYTICS: true
      MEILI_MASTER_KEY: ${MEILI_MASTER_KEY}
    volumes:
      - meilisearch:/meili_data

  db:
    image: postgres:16-alpine
    restart: unless-stopped
    volumes:
      - postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-hoarder123}
      POSTGRES_USER: hoarder
      POSTGRES_DB: hoarder

volumes:
  data:
  meilisearch:
  postgres:

Esta configuración incluye tres servicios esenciales que trabajan juntos: la aplicación principal, el motor de búsqueda Meilisearch para indexación rápida, y PostgreSQL como base de datos relacional.

Configuración avanzada de Hoarder Docker Compose

Una vez que la instalación básica esté funcionando, puedes optimizar el sistema con estas configuraciones adicionales:

Proxy inverso con SSL

Para acceder de forma segura desde internet, configura un proxy inverso con certificados SSL automáticos. Puedes usar Caddy o Traefik para gestionar el tráfico HTTPS.

Backups automáticos

Protege tus datos configurando copias de seguridad periódicas de los volúmenes Docker. Los directorios críticos son:

data: Archivos subidos y contenido guardado
postgres: Base de datos con toda la estructura y metadatos
meilisearch: Índices de búsqueda

Límites de recursos

Para evitar que la aplicación consuma todos los recursos del servidor, añade límites en el docker-compose.yml:

services:
  web:
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 2G
        reservations:
          memory: 512M

Uso práctico de Hoarder: Casos de uso reales

Esta herramienta brilla en múltiples escenarios profesionales y personales:

Para investigadores y estudiantes

Guarda artículos académicos, papers y recursos educativos con etiquetas automáticas. La búsqueda de texto completo permite encontrar citas específicas incluso dentro de PDFs escaneados gracias al OCR integrado.

Para desarrolladores

Centraliza documentación técnica, snippets de código y referencias de API. La extensión de navegador permite guardar ejemplos de Stack Overflow o repositorios de GitHub al instante.

Para creadores de contenido

Acumula inspiración visual, referencias de diseño y artículos relevantes. El sistema archiva páginas web completas, asegurando que el contenido permanezca accesible aunque el sitio original desaparezca.

Para equipos de trabajo

Aunque el sistema está diseñado principalmente para uso personal, múltiples usuarios pueden compartir una instancia creando cuentas individuales. Cada usuario mantiene su biblioteca privada de marcadores.

Actualización y mantenimiento de Hoarder Docker Compose

Mantener el sistema actualizado es fundamental para recibir nuevas funcionalidades y parches de seguridad:

Actualización con versión específica

Si usas versiones fijadas en el archivo .env, cambia el valor de KARAKEEP_VERSION a la versión deseada y recrea los contenedores:

docker compose up -d

Actualización a última versión

Si usas el tag release, fuerza la descarga de la última imagen disponible:

docker compose pull
docker compose up -d

Monitorización de logs

Para detectar problemas o errores, revisa los registros del sistema periódicamente:

docker compose logs -f web

Comparación: Hoarder vs otras alternativas

El mercado ofrece múltiples gestores de marcadores, pero cada uno tiene enfoques diferentes:

Característica	Hoarder	Linkwarden	Pocket	Raindrop
Self-hosted	✅ Sí	✅ Sí	❌ No	❌ No
IA automática	✅ Sí	❌ No	❌ No	✅ Limitada
OCR	✅ Sí	❌ No	❌ No	❌ No
Apps móviles	✅ iOS/Android	❌ No	✅ iOS/Android	✅ iOS/Android
Código abierto	✅ AGPL-3.0	✅ MIT	❌ No	❌ No
API REST	✅ Sí	✅ Sí	✅ Sí	✅ Sí

La principal ventaja competitiva es la combinación de etiquetado inteligente con IA, OCR integrado y control total sobre tus datos mediante self-hosting.

Resolución de problemas comunes

Error de conexión a Meilisearch

Si la búsqueda no funciona, verifica que el contenedor de Meilisearch esté corriendo:

docker compose ps

Comprueba que MEILI_MASTER_KEY coincida en ambos servicios.

El etiquetado automático no funciona

Revisa que tu clave de OpenAI sea válida o que Ollama esté accesible en la URL configurada. Verifica los logs para mensajes de error específicos.

Base de datos corrupta

Si experimentas errores de base de datos, restaura desde un backup reciente del volumen postgres. Por esto es crítico mantener copias de seguridad regulares.

Preguntas frecuentes sobre Hoarder Docker Compose

¿Es gratis usar Hoarder?

Sí, el software es completamente gratuito y de código abierto bajo licencia AGPL-3.0. Solo pagarás por tu servidor y, opcionalmente, por el uso de la API de OpenAI si eliges esa opción en lugar de modelos locales.

¿Puedo usar Hoarder sin IA?

Absolutamente. El etiquetado automático es opcional. Sin configurar OpenAI o Ollama, la aplicación funciona perfectamente como gestor de marcadores tradicional con búsqueda manual y organización por carpetas.

¿Qué recursos de servidor necesito?

Para uso personal ligero, 2GB de RAM y 1 CPU son suficientes. Si usas Ollama localmente o tienes una biblioteca extensa con miles de marcadores, considera 4GB de RAM y 2 CPUs para mantener buen rendimiento.

¿Funciona en Raspberry Pi?

Sí, la aplicación es compatible con arquitecturas ARM. Una Raspberry Pi 4 con 4GB de RAM ejecuta el servicio sin problemas para usuarios individuales, aunque el procesamiento de IA será más lento que en hardware x86.

¿Cómo importo marcadores existentes?

Actualmente el proyecto está desarrollando funcionalidades de importación desde navegadores y otros servicios. Consulta la documentación oficial para las opciones más recientes disponibles.

Conclusión: ¿Vale la pena instalar Hoarder Docker Compose?

Si valoras tu privacidad, necesitas organizar grandes cantidades de información digital y quieres aprovechar inteligencia artificial para automatizar el etiquetado, esta solución ofrece una propuesta sólida sin depender de servicios comerciales externos.

La instalación mediante Docker Compose simplifica el despliegue y mantenimiento, mientras que las aplicaciones móviles y extensiones de navegador proporcionan acceso ubicuo a tu biblioteca personal de conocimiento. Con más de 21,000 usuarios en GitHub respaldando el proyecto, la comunidad activa garantiza soporte continuo y nuevas funcionalidades.

Para maximizar tu ecosistema self-hosted, considera combinar esta herramienta con n8n para automatizar la captura de contenido desde feeds RSS o servicios externos. El resultado es un sistema completamente personalizado que trabaja exactamente como tú necesitas.

Hoarder Docker Compose: Gestor de Marcadores con IA 2025