Skip to main content

Linkwarden: Gestor de marcadores autohospedado para almacenar y organizar enlaces

Introducción

Este artículo documenta Linkwarden, un gestor de marcadores autohospedado orientado a centralizar, preservar y organizar enlaces sin depender de servicios externos. Se integra dentro del stack como un servicio web interno, desplegado en contenedores y respaldado por una base de datos PostgreSQL persistente.

A diferencia de soluciones enfocadas en “leer más tarde”, Linkwarden está pensado como archivo a largo plazo: permite conservar enlaces incluso si el contenido original desaparece, facilitando búsquedas posteriores sobre material técnico, documentación, referencias o recursos personales.

Enfoque general

Linkwarden actúa como una biblioteca de enlaces, no como una lista temporal. Cada marcador puede almacenarse junto con:

  • Metadatos (título, descripción).
  • Etiquetas y colecciones.
  • Copia del contenido (HTML) y/o captura visual.

Este enfoque evita el link rot y permite consultar información incluso cuando la fuente original deja de estar disponible.

El servicio se expone vía HTTP y queda protegido externamente mediante proxy inverso y autenticación centralizada.

Configuración utilizada (solo enlaces)

La configuración completa se mantiene versionada en Gitea:

Repositorio personal en Gitea – Linkwarden

Incluye:

  • docker-compose.yml
  • .env
  • Definición de volúmenes persistentes
  • Conexión a PostgreSQL separada del contenedor principal

Detalles clave del despliegue

  • Puerto expuesto: 3009 Acceso directo en red interna:

    http://<IP-del-servidor>:3009

  • Base de datos PostgreSQL dedicada Separar la base de datos permite:

    • Persistencia real de datos.
    • Backups independientes.
    • Actualizaciones del contenedor sin riesgo de pérdida.

  • Registro de usuarios deshabilitado por defecto Controlado mediante:

    NEXT_PUBLIC_DISABLE_REGISTRATION=true

    Esto fuerza la creación inicial controlada y evita altas no deseadas si el servicio queda expuesto.

Primeros pasos (resumen operativo)

Aunque la configuración real está en Gitea, el flujo general es:

  1. Clonar el repositorio oficial de Linkwarden:

    git clone https://github.com/linkwarden/linkwarden.git
cd linkwarden

  2. Definir variables en el archivo .env (ver repositorio en Gitea para valores y estructura).

  3. Levantar el stack:

    docker-compose up -d

  4. Acceder vía navegador y crear el usuario inicial (solo posible si el registro está habilitado temporalmente o mediante configuración inicial).

Este apartado describe el flujo lógico, no sustituye la configuración real versionada.

Validación

Comprobaciones básicas tras el despliegue:

  • El contenedor web responde en el puerto configurado.
  • La base de datos PostgreSQL acepta conexiones desde el servicio.
  • No aparecen errores relevantes en los logs del contenedor.
  • La interfaz web permite crear y consultar marcadores.
  • Las capturas y archivos asociados se almacenan correctamente en los volúmenes persistentes.

Notas personales

  • Desplegado en local y accesible desde LAN y exterior.
  • Protegido mediante Authentik a nivel de proxy.
  • Usado como almacén central de enlaces (técnicos y personales).
  • Especialmente útil para recuperar recursos ya guardados cuando no se recuerda su origen exacto.

Referencias

Back to top