Cómo instalar Memos con Docker Compose: ¡PASOS FÁCILES!

Memos es una app de notas autoalojada para la gestión del conocimiento personal. Es de código abierto (licencia MIT), funciona con Go + React y supera las 60.000 estrellas en GitHub en su v0.30.0 (julio de 2025). Usa SQLite por defecto, soporta Markdown de serie y funciona sin problemas con 1 CPU / 1 GB de RAM. Esta guía te lleva paso a paso por la instalación de Memos con Docker Compose usando SQLite o PostgreSQL, detrás de un proxy inverso Traefik con TLS automático.

¿Qué es Memos?

Memos es una aplicación de notas autoalojada centrada en la privacidad. Todos los datos permanecen en tu servidor. Sin dependencia de la nube, sin suscripción, sin rastreo. La interfaz es limpia: escribes Markdown, se renderiza en vivo y todo se sincroniza entre tus dispositivos a través de la interfaz web.

Funciones principales:

• Soporte de Markdown con el nuevo editor CodeMirror 6 y barra de herramientas de formato (v0.30.0)
• Arquitectura ligera: el backend en Go y el frontend en React mantienen bajo el uso de memoria
• Interfaz personalizable: temas claro/oscuro, nombre del servidor, icono, descripción
• Acceso multidispositivo desde cualquier navegador
• Adjuntos guardados en el sistema de archivos por defecto desde la v0.27.0 (no dentro de la base de datos)
• Código abierto bajo licencia MIT. Contribuye o haz un fork como quieras.

Si necesitas algo más completo para la documentación de equipo, consulta Cómo instalar Outline Wiki en Docker o Instalación de Docmost con Docker Compose.

Desde la publicación original, Memos ha añadido varias funciones que conviene conocer:

• Web Clipper, extensión de navegador para Chrome y Firefox
• Notas de voz con transcripción por IA mediante proveedores OpenAI o Gemini
• Servidor MCP en /mcp para integración con clientes de IA (Model Context Protocol)
• Editor CodeMirror 6 con barra de herramientas de formato estilo WYSIWYG
• Diseños de feed en varias columnas: 1, 2 o 3 columnas más ajuste automático
• Actualización en vivo por SSE: cambios en tiempo real sin polling
• Webhooks estándar con firma HMAC-SHA256
• Configuración gestionada por despliegue mediante archivos JSON en /etc/secrets para flujos de trabajo GitOps

Instala Memos con Docker Compose

Abajo tienes dos configuraciones completas: SQLite (la más simple, recomendada para uso personal) y PostgreSQL (para cuando ya usas Postgres o quieres copias de seguridad con pg_dump).

Requisitos previos

Los precios de los VPS subieron en todos los proveedores en 2026 — si estás reconsiderando un servidor alquilado, mira qué cambió y cuándo gana un mini PC.

Puedes gestionar los stacks de Docker Compose con Dockge o cualquiera de los mejores paneles de servidores autoalojados.

Inicio rápido: Memos con SQLite

SQLite es el backend por defecto y la forma más sencilla de empezar. Un contenedor, un volumen y ningún servicio de base de datos que gestionar.

services:
  memos:
    image: neosmemo/memos:stable
    container_name: memos
    restart: unless-stopped
    networks:
      - traefik-net
    volumes:
      - ./memos:/var/opt/memos
    environment:
      MEMOS_DRIVER: sqlite
      MEMOS_PORT: 5230
      # Set this to your public URL to enable public mode.
      # Leave empty for private-only (no anonymous access, no RSS, no Explore).
      MEMOS_INSTANCE_URL: https://memos.yourdomain.com
      # MEMOS_LOG_LEVEL: debug  # Uncomment for troubleshooting
    labels:
      - traefik.enable=true
      - traefik.http.routers.memos.rule=Host(`memos.yourdomain.com`)
      - traefik.http.routers.memos.entrypoints=websecure
      - traefik.http.routers.memos.tls.certresolver=letsencrypt
      - traefik.http.services.memos.loadbalancer.server.port=5230

networks:
  traefik-net:
    external: true

Qué hace esto:

• neosmemo/memos:stable descarga la última versión estable (actualmente v0.30.0)
• El volumen ./memos:/var/opt/memos persiste todos los datos (base de datos + adjuntos) en el host
• Las etiquetas de Traefik enrutan memos.yourdomain.com al puerto 5230 con TLS automático mediante tu cert resolver
• El contenedor se ejecuta como non-root por defecto (UID 10001); no hace falta user: root

Si no usas Traefik (por ejemplo, Cloudflare Tunnel o acceso directo), sustituye el bloque labels por un mapeo de puertos:

ports:
  - 5230:5230

Elimina la sección networks si no usas una red externa de Traefik.

Memos con PostgreSQL

Usa PostgreSQL si ya lo ejecutas para otros servicios, si quieres soporte de copias de seguridad con pg_dump o si prefieres un backend de base de datos gestionado. MySQL también está soportado. Consulta la documentación de bases de datos de Memos para ver las cadenas de conexión.

services:
  memos:
    image: neosmemo/memos:stable
    container_name: memos
    restart: unless-stopped
    networks:
      - traefik-net
    depends_on:
      memos-db:
        condition: service_healthy
    volumes:
      - ./memos:/var/opt/memos
    environment:
      MEMOS_DRIVER: postgres
      MEMOS_DSN: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@memos-db:5432/${POSTGRES_DB}?sslmode=disable
      MEMOS_PORT: 5230
      MEMOS_INSTANCE_URL: https://memos.yourdomain.com
    labels:
      - traefik.enable=true
      - traefik.http.routers.memos.rule=Host(`memos.yourdomain.com`)
      - traefik.http.routers.memos.entrypoints=websecure
      - traefik.http.routers.memos.tls.certresolver=letsencrypt
      - traefik.http.services.memos.loadbalancer.server.port=5230

  memos-db:
    image: postgres:16-alpine
    restart: unless-stopped
    networks:
      - traefik-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
    volumes:
      - ./memos-db:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}

networks:
  traefik-net:
    external: true

El depends_on con condition: service_healthy garantiza que Memos no arranque hasta que PostgreSQL acepte conexiones. El contenedor de PostgreSQL usa postgres:16-alpine para mantener una imagen de tamaño reducido.

Crea el archivo .env

La configuración con SQLite no necesita un archivo .env. Para PostgreSQL, crea un archivo .env en el mismo directorio que tu docker-compose.yml:

POSTGRES_DB=memos
POSTGRES_USER=memos
POSTGRES_PASSWORD=change-me-to-a-strong-random-password

Inicia Memos

docker compose up -d

Esto descarga las imágenes, crea los contenedores y arranca todo en segundo plano (detached).

Verifica que funciona

Después de docker compose up -d, confirma que todo está en buen estado:

# Check container status — both should be "Up" and (for postgres) "healthy"
docker compose ps

# Check Memos logs for startup confirmation
docker compose logs memos
# Look for: "Server started at http://localhost:5230"

# Quick HTTP check
curl -I http://localhost:5230
# Expect: HTTP/1.1 200 OK

Si el contenedor se reinicia, revisa los logs con docker compose logs memos --tail 50 para ver los mensajes de error.

Accede a la interfaz de Memos

Abre https://memos.yourdomain.com en tu navegador. El primer usuario que crees será el administrador. Verás el feed principal de memos:

Desde la página de Ajustes puedes cambiar entre los temas claro y oscuro, gestionar usuarios, configurar SSO/OAuth2 (URL de callback: https://<instance>/auth/callback) y definir los backends de almacenamiento:

Referencia de variables de entorno

Consulta la documentación completa de variables de entorno para todas las opciones.

Copias de seguridad y actualización de Memos

Copias de seguridad

Las copias de seguridad dependen del backend de base de datos que uses. No te las saltes, sobre todo antes de actualizar.

SQLite:

# Stop Memos for a consistent snapshot
docker compose stop memos
tar -czf memos-backup-$(date +%Y%m%d).tar.gz ./memos/
docker compose start memos

PostgreSQL:

# No downtime needed — pg_dump is consistent
docker compose exec memos-db pg_dump -U memos memos > memos-dump-$(date +%Y%m%d).sql

Actualización

Memos publica versiones con frecuencia. Haz siempre una copia de seguridad primero y revisa el changelog por si hay cambios que rompen la compatibilidad.

# 1. Backup (see above)
# 2. Pull the new image
docker compose pull
# 3. Recreate containers
docker compose up -d
# 4. Verify
docker compose logs memos
# Look for: "Server started at http://localhost:5230"

Después de actualizar, limpia las imágenes Docker antiguas para liberar espacio en disco. Consulta Cómo limpiar todas las imágenes Docker.

Solución de problemas

docker compose logs memos --tail 100

environment:
  MEMOS_INSTANCE_URL: https://memos.yourdomain.com

docker compose ps
# memos-db should show "healthy" in the STATUS column
docker compose logs memos-db
# Look for: "database system is ready to accept connections"

Seguridad y endurecimiento para producción

Memos v0.30.0 se ejecuta como UID 10001 por defecto. No lo sobrescribas con user: root; no hay motivo para hacerlo. Pon Memos siempre detrás de un proxy inverso con TLS. Traefik + Let’s Encrypt es el camino recomendado. Nunca expongas el puerto 5230 directamente a internet.

Expón solo los puertos 80 y 443. Bloquea el acceso directo al 5230 desde fuera. Para instancias públicas, considera añadir el middleware de rate-limit de Traefik para evitar abusos.

Memos publica versiones con frecuencia. Suscríbete a las releases de GitHub y actualiza cada mes. Configura copias de seguridad diarias automáticas en un almacenamiento compatible con S3. Una copia local en el mismo disco es mejor que nada, pero no te salvará de un fallo de disco.

Novedades de Memos v0.27 a v0.30

Si instalaste Memos antes de agosto de 2024, esto es lo que ha cambiado:

El Web Clipper y el servidor MCP son las incorporaciones destacadas. El clipper te permite guardar páginas web directamente en Memos desde el navegador. El endpoint MCP hace que Memos sea accesible para clientes de IA compatibles con el Model Context Protocol.

Conclusiones

Configurar Memos con Docker Compose lleva menos de 10 minutos. SQLite es la opción por defecto por una razón: cero configuración, un volumen y listo. PostgreSQL añade controles operativos si los necesitas. En cualquier caso, haz copias de seguridad de tus datos y revisa el changelog antes de actualizar.

Si te interesa descubrir apps autoalojadas de código abierto, gratuitas e interesantes, puedes consultar la sección self hosted de toolhunt.net.

Para más herramientas autoalojadas y configuraciones de Docker, echa un vistazo a los mejores paneles de servidores autoalojados o explora la lista completa a continuación.