Alojar Linkwarden en VPS: gestión de marcadores de equipo

Por qué alojar Linkwarden uno mismo

Lo que Linkwarden aporta a una agencia

• Colecciones compartidas — cada proyecto o cliente dispone de su propia colección, accesible al equipo implicado sin exponer las demás carpetas.
• Permisos por miembro — los permisos se gestionan a nivel de colección: lector, colaborador o gestor, según el rol de cada uno.
• Anotaciones comunes — los miembros de una colección pueden dejar notas en cada enlace, lo que evita duplicar búsquedas y capitaliza la vigilancia.
• Extensión de navegador multiusuario — cada colaborador instala la extensión en su navegador y guarda directamente en la colección de destino, sin abrir la interfaz web.
• Archivado de las páginas — Linkwarden conserva una copia local de las páginas guardadas, lo que evita perder un recurso desaparecido de la web.
• API REST — los enlaces se integran en otras herramientas internas mediante la API, sin depender de una interfaz gráfica.
• Control total de los datos — ningún análisis del comportamiento, ninguna sindicación externa de los marcadores hacia terceros.

Requisitos previos antes de la instalación

Despliegue paso a paso

1. 01

   Preparar el directorio de trabajo

   Conéctese por SSH a su VPS como root o mediante un usuario con sudo, y cree la carpeta que albergará los archivos de configuración:

   mkdir -p /opt/linkwarden && cd /opt/linkwarden

2. 02

   Crear el archivo Compose

   Cree un archivo docker-compose.yml con el contenido siguiente. Los valores entre ángulos deben sustituirse antes de arrancar:

   services:
     postgres:
       image: postgres:16-alpine
       restart: unless-stopped
       environment:
         POSTGRES_DB: linkwarden
         POSTGRES_USER: linkwarden
         POSTGRES_PASSWORD: <contrasena-db>
       volumes:
         - postgres_data:/var/lib/postgresql/data
   
     linkwarden:
       image: ghcr.io/linkwarden/linkwarden:latest
       restart: unless-stopped
       depends_on:
         - postgres
       environment:
         DATABASE_URL: postgresql://linkwarden:<contrasena-db>@postgres:5432/linkwarden
         NEXTAUTH_SECRET: <cadena-aleatoria-32-caracteres>
         NEXTAUTH_URL: https://su-dominio.com
       volumes:
         - linkwarden_data:/data/data
       ports:
         - "127.0.0.1:3000:3000"
   
   volumes:
     postgres_data:
     linkwarden_data:

   Para generar el valor de NEXTAUTH_SECRET, ejecute en el servidor: openssl rand -base64 32.

3. 03

   Configurar la variable NEXTAUTH_URL con cuidado

   La variable NEXTAUTH_URL debe corresponder exactamente a la URL pública de su instancia, protocolo incluido. Si su instancia está detrás de un reverse proxy TLS, el valor debe empezar por https:// y no por http://.

   Un NEXTAUTH_URL mal formado produce el error siguiente en la primera carga de la interfaz: Error: NEXTAUTH_URL is not configured. Please set NEXTAUTH_URL in your .env. Si el valor está en http:// mientras el proxy sirve HTTPS, la sesión no se crea y la página de inicio de sesión se recarga en bucle sin ningún mensaje de error visible.

4. 04

   Iniciar los contenedores

   Desde /opt/linkwarden, ejecute:

   docker compose up -d

   Se descargan las imágenes y PostgreSQL arranca en primer lugar. Linkwarden espera a que la base esté lista antes de inicializar el esquema. Compruebe que los dos contenedores están en estado running con docker compose ps.

5. 05

   Configurar el reverse proxy (nginx)

   Linkwarden escucha en 127.0.0.1:3000. Añada un bloque de servidor nginx para proxificar el tráfico HTTPS:

   server {
       listen 443 ssl;
       server_name su-dominio.com;
   
       ssl_certificate     /etc/letsencrypt/live/su-dominio.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/su-dominio.com/privkey.pem;
   
       location / {
           proxy_pass http://127.0.0.1:3000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   }

   Recargue nginx con nginx -t && systemctl reload nginx.

6. 06

   Generar el certificado TLS

   Si aún no lo ha hecho, genere un certificado Let's Encrypt con Certbot:

   certbot --nginx -d su-dominio.com

   Certbot modifica automáticamente el bloque nginx para añadir las rutas del certificado y la redirección de HTTP hacia HTTPS. La renovación es automática mediante el timer de systemd que instala el paquete.

7. 07

   Crear la primera cuenta de administrador

   Abra https://su-dominio.com en un navegador. Linkwarden propone crear la primera cuenta en el primer acceso. Esa cuenta se convierte en la administradora de la instancia. Después, invite a cada colaborador desde el panel Configuración → Miembros indicando su dirección de correo electrónico.

8. 08

   Distribuir la extensión de navegador

   La extensión de Linkwarden está disponible en Chrome Web Store y en Firefox Add-ons. En la primera configuración, cada miembro indica la URL de la instancia (https://su-dominio.com) y genera un token de API desde Configuración → Tokens de acceso. Los marcadores guardados desde la extensión llegan directamente a la colección elegida por el usuario.

Linkwarden o Karakeep: dos usos distintos

Linkwarden vs Karakeep — tabla comparativa

Desplace la tabla

Resolución de problemas: errores comunes en la instalación

El paso siguiente: centralizar todos los servicios de la agencia