Cómo instalar Blinko en Docker - Aplicación de notas con IA autohospedada en Docker

Blinko | AI Notes | Docker

Blinko: Aplicación de notas con IA integrada autohospedada en Docker

Notas rápidas con IA. RAG (Retrieval-Augmented Generation). Búsqueda natural. Privacy-first. Next.js + TypeScript. PostgreSQL. Markdown. RSS. Compartir notas públicas. Open source.

¿Qué es Blinko?



Blinko es una aplicación de notas AI-powered minimalista diseñada para capturar ideas rápidamente con búsqueda inteligente usando RAG (Retrieval-Augmented Generation). A diferencia de Notion (complejo), Evernote (caro), o Obsidian (local-only), Blinko es una solución self-hosted que combina captura rápida de notas con búsqueda inteligente potenciada por IA.

Características principales: AI-Enhanced Note Retrieval con RAG. Búsqueda natural en lenguaje simple. Captura rápida de ideas ("Blinko" para pensamientos efímeros vs "Notes" para contenido permanente). Markdown completo. Full-text search. Markdown support. Sistema de etiquetas. Auto-archiving. Compartir notas públicamente. RSS feed support. Next.js + TypeScript. PostgreSQL. Two-factor authentication. No tracking, no ads. Completamente self-hosted en tu servidor.

Diferenciador clave: Blinko no es solo un note-taker. Es un knowledge base AI-powered. La IA entiende tus notas y las encuentra cuando las necesitas, sin necesidad de tags perfectos.

Características principales

AI RAG Search

Busca con lenguaje natural. "Cómo instalar Docker" encuentra la nota relevante.

Captura rápida

Blinko para ideas efímeras. Notes para contenido permanente.

Markdown completo

Encabezados, listas, código, tablas. Formato profesional.

Full-text search

Busca tradicional + AI-powered. Encuentra exactamente qué necesitas.

Etiquetas & organizacion

Tags para categorizar. Pero AI entiende contexto sin tags perfectos.

RSS integration

Suscríbete a feeds. Artículos aparecen en tu knowledge base.

Compartir publicamente

Genera link único. Comparte nota sin cuenta Blinko requerida.

Auto-archive

Ideas efímeras se archivan automáticamente después período configurable.

2FA integrado

Autenticación de dos factores para seguridad.

Privacy-first

Self-hosted. Sin tracking. Sin ads. Datos 100% tuyos.

Open source

TypeScript. GitHub. Comunidad. Código transparente.

Docker ready

Docker Compose. PostgreSQL incluido. Deploy en minutos.

Requisitos del sistema

  • Docker & Docker Compose
  • 1-2 GB RAM (Next.js + PostgreSQL)
  • 5+ GB espacio disco (BD + notas + modelos IA)
  • Puerto 1111 para Blinko (configurable)
  • PostgreSQL (incluido en docker-compose)
  • Navegador moderno para UI Next.js
Ligero: Blinko consume recursos moderados. Perfecto para VPS $5-10, Raspberry Pi con poder, cualquier servidor decente.

Instalación con Docker Compose

Paso 1: Clonar repositorio

git clone https://github.com/blinkospace/blinko cd blinko

Paso 2: Generar SECRET_KEY

# Generar string aleatorio seguro (32 bytes en base64) openssl rand -base64 32 # Copia el resultado. Lo necesitarás en .env

Paso 3: Crear docker-compose.yml

cat > docker-compose.yml << 'EOF' version: '3.8' networks: blinko-network: driver: bridge services: postgres: image: postgres:15 container_name: blinko-postgres restart: unless-stopped environment: - POSTGRES_DB=blinko - POSTGRES_PASSWORD=tu-contraseña-db volumes: - postgres_data:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 10s timeout: 5s retries: 5 networks: - blinko-network blinko-website: image: blinkospace/blinko:latest container_name: blinko-website restart: unless-stopped ports: - "1111:3000" environment: - NODE_ENV=production - NEXTAUTH_SECRET=TU_STRING_GENERADO - DATABASE_URL=postgresql://postgres:tu-contraseña-db@postgres:5432/blinko - NEXT_PUBLIC_BASE_URL=http://localhost:1111 depends_on: postgres: condition: service_healthy networks: - blinko-network volumes: postgres_data: EOF

Paso 4: Reemplazar valores en docker-compose.yml

# Edita el archivo y reemplaza: # - tu-contraseña-db → contraseña PostgreSQL segura # - TU_STRING_GENERADO → resultado de openssl rand -base64 32

Paso 5: Iniciar containers

docker compose up -d # Esperar a que PostgreSQL esté listo (unos 10-15 segundos) docker logs -f blinko-website

Acceder

http://localhost:1111/signup - Crear cuenta admin

Primeros pasos

1. Crear cuenta admin

  1. Abre http://localhost:1111/signup
  2. Username y password para admin account
  3. Click Sign Up
  4. Serás redirigido al dashboard

2. Entender Blinko vs Notes

  1. Blinko: Ideas rápidas, efímeras. Se archivan automáticamente.
  2. Notes: Contenido permanente. Knowledge base a largo plazo.
  3. Usa "Blinko" para pensamientos rápidos. "Notes" para documentación importante.

3. Capturar tu primera idea

  1. Haz click en la sección "Blinko" (lado izquierdo)
  2. Escribe algo en el textarea
  3. Presiona Enter o click en botón send
  4. Tu idea aparece en la timeline

4. Crear una nota permanente

  1. Click en "Notes" (lado izquierdo)
  2. Click "Create Note"
  3. Título y contenido en Markdown
  4. Tags para categorizar
  5. Save

5. Probar búsqueda AI

  1. En buscador superior, escribe en lenguaje natural
  2. Ej: "Cómo instalar Docker" o "Mi receta favorita"
  3. Blinko busca usando AI RAG, no solo palabras clave
  4. Resultados aparecen en tiempo real

6. Agregar RSS feed

  1. Click Settings (abajo izquierda)
  2. RSS → Add Feed
  3. Pega URL del feed (ej: news site RSS)
  4. Nuevos artículos aparecen en sección RSS
  5. Puedes guardar artículos interesantes como notes

7. Compartir nota públicamente

  1. Abre cualquier note
  2. Click en icono share (esquina superior derecha)
  3. Enable "Public sharing"
  4. Copia link único
  5. Comparte con alguien. Verán la nota sin login

Casos de uso

  • Knowledge base personal: Documentación de aprendizaje. Snippets. Tutoriales.
  • Developer journal: Notas técnicas. Soluciones a problemas. Logs.
  • Research hub: Recopila artículos RSS. Anotaciones. Análisis.
  • Idea capture: Captura rápida de ideas creativas durante el día.
  • Project documentation: Wiki interno para equipos pequeños.
  • Learning notes: Toma notas mientras estudias. AI te ayuda a encontrarlas después.
  • Blog idea bank: Ideas para posts. Snippets para reutilizar.

HTTPS con Caddy (producción)

Caddyfile

blinko.tudominio.com { reverse_proxy localhost:1111 }

Actualizar NEXT_PUBLIC_BASE_URL

NEXT_PUBLIC_BASE_URL=https://blinko.tudominio.com

Acceso remoto seguro

https://blinko.tudominio.com con HTTPS automático de Caddy

Gestión y mantenimiento

Ver logs

docker logs -f blinko-website docker logs -f blinko-postgres

Backup de base de datos

docker exec blinko-postgres pg_dump -U postgres -d blinko > blinko-backup-$(date +%Y%m%d).sql

Restore de backup

docker exec -i blinko-postgres psql -U postgres -d blinko < blinko-backup-20260522.sql

Reiniciar servicios

docker compose restart

Actualizar Blinko a versión más reciente

docker compose pull docker compose up -d

Ver tamaño de la base de datos

docker exec blinko-postgres du -sh /var/lib/postgresql/data

Limpiar volumes (cuidado: borra datos)

docker compose down -v # SOLO si quieres empezar desde cero

Comparativa con alternativas

vs Notion

Blinko gana: Self-hosted, AI search built-in, simple, RSS. Notion gana: Más potente, bases de datos, templates.

vs Obsidian

Blinko gana: Web-based, AI RAG, compartir público. Obsidian gana: Local-first, plugins, comunidad grande.

vs Memos

Blinko gana: AI RAG search, more features. Memos gana: Más simple, timeline visual.

vs LogSeq

Blinko gana: AI search, web-based. LogSeq gana: Grafo de conocimiento, linked references.

Mejor para: Quien quiera capturar y buscar notas con AI. Self-hosted. Privacy-first. Búsqueda inteligente sin dejar de ser simple.

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

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.