Alojar wallabag en un VPS administrado: sus lecturas pendientes en su servidor

Alojar wallabag en un VPS administrado significa guardar los artículos que reserva para leer más tarde en una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. wallabag es una aplicación libre de lectura diferida con licencia MIT. Esta guía sigue su documentación oficial y su imagen Docker, en la versión 2.6.17: la instalación con Docker Compose, la primera cuenta y los secretos, HTTPS, las aplicaciones y las extensiones, la importación desde Pocket y otros servicios, el correo, las copias de seguridad y las actualizaciones.

Simon Vasconcelos Lee Por Publicado el 18 de noviembre de 202614 minutos de lectura

Todas las guías

Lo esencial

  1. La licencia MIT permite usar, modificar y redistribuir wallabag libremente, en una empresa o en cualquier otro ámbito, siempre que conserve su aviso de copyright.
  2. Instálelo con Docker Compose: la imagen oficial wallabag/wallabag, MariaDB, Redis y el puerto web publicado en 127.0.0.1 detrás de un proxy inverso en HTTPS.
  3. Antes del primer inicio, defina SYMFONY__ENV__SECRET y su dirección pública en SYMFONY__ENV__DOMAIN_NAME; después cambie la contraseña de la cuenta wallabag, que es wallabag.
  4. El proxy inverso envía X-Forwarded-Proto: https: así sabe wallabag que sus visitantes llegan por HTTPS.
  5. Haga copia de la base de datos, del volumen de imágenes y de su compose.yaml, y actualice cambiando la etiqueta de la imagen y ejecutando las migraciones.

Qué hace wallabag

wallabag es una aplicación web de lectura diferida: guarda una página con un clic y la lee cuando tiene tiempo. Su README lo resume así: hacer clic, guardar y leer cuando quiera. wallabag extrae el contenido del artículo, para que las ventanas emergentes de la página original no le distraigan.

Lo que permite la licencia MIT

wallabag se publica con la licencia MIT, copyright Nicolas Lœuillet desde 2013. Concede, de forma gratuita, el derecho a usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y vender copias del software. Puede, por tanto, ejecutarlo para usted, su equipo o sus clientes, sin ninguna licencia que comprar.

La única condición es conservar el aviso de copyright y el texto de la licencia en todas las copias o partes sustanciales del software. El texto ofrece el software «tal cual», sin garantía.

Los recursos que hay que prever

La documentación de wallabag no da cifras de memoria ni de procesador. Sí enumera lo que necesita la aplicación, y la imagen Docker fija algunos valores que ayudan a dimensionar:

El tamaño del servidor depende, por tanto, del número de usuarios, del volumen de artículos y de sus importaciones. En un VPS administrado, cuéntenos su uso y le recomendaremos el tamaño adecuado.

La instalación con Docker Compose

El repositorio wallabag/docker publica la imagen oficial wallabag/wallabag en Docker Hub y en GitHub Container Registry, con un archivo Compose de ejemplo: wallabag, una base de datos MariaDB y Redis. En un servidor con Docker instalado, cree una carpeta y coloque en ella este compose.yaml, basado en ese ejemplo:

compose.yaml
services:
  wallabag:
    image: wallabag/wallabag:2.6.17
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
      - SYMFONY__ENV__DATABASE_DRIVER=pdo_mysql
      - SYMFONY__ENV__DATABASE_HOST=db
      - SYMFONY__ENV__DATABASE_PORT=3306
      - SYMFONY__ENV__DATABASE_NAME=wallabag
      - SYMFONY__ENV__DATABASE_USER=wallabag
      - SYMFONY__ENV__DATABASE_PASSWORD=database-password
      - SYMFONY__ENV__DATABASE_CHARSET=utf8mb4
      - SYMFONY__ENV__SECRET=random-secret-string
      - SYMFONY__ENV__DOMAIN_NAME=https://read.example.com
      - SYMFONY__ENV__MAILER_DSN=smtp://user:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - wallabag-images:/var/www/wallabag/web/assets/images
    depends_on:
      - db
      - redis
  db:
    image: mariadb
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
    volumes:
      - wallabag-db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "/usr/local/bin/healthcheck.sh", "--innodb_initialized"]
      interval: 20s
      timeout: 3s
  redis:
    image: redis:alpine
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 20s
      timeout: 3s

volumes:
  wallabag-images:
  wallabag-db:

Sustituya los tres valores secretos antes del primer inicio. Las cadenas hexadecimales funcionan en todas partes, también en los comandos SQL que escribe la imagen para crear la base de datos:

Terminal
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag

Para comprobar que la aplicación responde, consulte la ruta que usa la comprobación de estado de la imagen:

Terminal
curl http://127.0.0.1:8080/api/info

La imagen vuelve a leer las variables SYMFONY__ENV__* en cada inicio del contenedor y vacía la caché. Después de modificar el compose.yaml, un docker compose up -d recrea el contenedor y aplica los nuevos ajustes.

Con SQLite o PostgreSQL

Sin Docker

La vía que recomienda la documentación en un servidor dedicado es el repositorio Git y su Makefile, con Composer, la herramienta make y las extensiones PHP de la página de requisitos:

Terminal
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install

El servidor web sirve entonces la carpeta web, con app.php como punto de entrada: la página de hosts virtuales da configuraciones para Nginx, Apache, Caddy y lighttpd. Sus ejemplos sirven wallabag en la raíz de un dominio o subdominio, la configuración que mantienen sus responsables.

La primera cuenta, los secretos y los registros

La instalación crea una cuenta de administrador cuyo usuario y contraseña son ambos wallabag, con la dirección wallabag@wallabag.io. Cámbielos antes de abrir la instancia al público. Un túnel SSH lleva el puerto 8080 del servidor a su ordenador, en http://localhost:8080; añada -p y el puerto SSH indicado en su área de cliente.

Terminal, en su ordenador
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Inicie sesión con wallabag y wallabag.
  2. En «Config», pestaña «Password», elija una nueva contraseña de al menos 8 caracteres.
  3. En la pestaña «User information», sustituya la dirección de correo por la suya: es la que recibe los enlaces para restablecer la contraseña.
  4. En la misma pestaña, active la autenticación en dos pasos. La documentación recomienda una aplicación de códigos de un solo uso, como FreeOTP, antes que el código enviado por correo; wallabag ofrece también códigos de respaldo.
VariableValor por defectoLo que hace
SYMFONY__ENV__SECRETUna cadena pública, la misma para todas las instanciasAporta entropía a las operaciones de seguridad: la documentación la quiere única para su instancia
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgLa dirección completa de su instancia, sin barra final
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse en la imagen DockerAbre o cierra el registro público
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueEnvía un correo de confirmación por cada registro
SYMFONY__ENV__LOCALEenEl idioma por defecto de la instancia, como es
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceEl nombre de la instancia que muestra su aplicación de doble autenticación

Con la imagen Docker, el registro público está por tanto cerrado. Para abrir la instancia a su equipo, cree usted mismo las cuentas desde «Users management», o abra el registro mientras las personas se inscriben, con confirmación por correo.

Los ajustes más sensibles están en «Internal Settings», reservados al administrador de la instancia: el uso compartido público de artículos, los formatos de exportación, el inicio de sesión en sitios de pago, la descarga local de imágenes y las importaciones en segundo plano.

HTTPS: el proxy inverso

El contenedor sirve wallabag en HTTP, en su puerto 80, mediante un Nginx interno. HTTPS corre a cargo del proxy inverso situado delante. Ese Nginx interno lee la cabecera X-Forwarded-Proto: cuando vale https, indica a PHP que la petición está cifrada, y wallabag construye sus enlaces y sus cookies en consecuencia.

Con Caddy

Caddy obtiene por sí mismo el certificado de Let’s Encrypt y lo renueva. Su directiva reverse_proxy conserva la cabecera Host y añade por defecto X-Forwarded-For, X-Forwarded-Proto y X-Forwarded-Host:

Caddyfile
read.example.com {
  reverse_proxy 127.0.0.1:8080
}

Con Nginx

Este bloque retoma las cabeceras del ejemplo Nginx del README de la imagen Docker, añade la cabecera Host y el límite de envío de la imagen, y escucha en el puerto 80 para que Certbot pueda instalar HTTPS:

Bloque Nginx
server {
    listen 80;
    listen [::]:80;
    server_name read.example.com;
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $server_name;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

Compruebe después que SYMFONY__ENV__DOMAIN_NAME contiene la dirección en https://, la misma que la de su proxy.

Las aplicaciones, las extensiones y las fuentes RSS

wallabag funciona en el navegador, y el proyecto publica también aplicaciones y una extensión, que se conectan a su instancia por su dirección, sin barra final.

HerramientaLo que haceLo que necesita
Aplicación para AndroidSincroniza sus listas de artículos y las muestra en su teléfonoLa dirección de la instancia, su usuario y su contraseña; la aplicación obtiene por sí misma sus accesos a las fuentes
Aplicación para iOSMuestra sus artículos en iPhone y iPadLa dirección, un identificador y un secreto de cliente de la API, su usuario y su contraseña
Extensión wallabagger, para Firefox y ChromeGuarda la página abierta, con sus etiquetas, como favorita o archivadaLa dirección, un identificador y un secreto de cliente de la API, su usuario y su contraseña
Marcador «bag it!»Guarda la página abierta desde la barra de marcadoresNada: se arrastra desde la página «Howto»

Importar sus artículos desde Pocket y otros servicios

El menú «Import» trae sus artículos desde otro servicio. wallabag vuelve a descargar el contenido de cada artículo, lo que lleva tiempo con una exportación grande. Los importadores de la versión 2.6.17:

ServicioEl archivo que hay que aportar
Pocket, exportación CSVEl ZIP de exportación de Pocket, una vez descomprimido: un archivo CSV con un nombre como part_000000.csv
Pocket, exportación HTMLEl archivo HTML de la exportación antigua de Pocket, como ril_export.html
InstapaperEl CSV de la página de ajustes de Instapaper
OmnivoreLos archivos metadata_x_to_y.json de la exportación descomprimida, uno por uno
Pinboard, DeliciousSu exportación JSON
ShaarliSu exportación HTML
Firefox, ChromeLa copia de seguridad JSON de los marcadores de Firefox, o el archivo Bookmarks de Chrome
Readability, elCuratorSu exportación
wallabag 1.x o 2.xLa exportación JSON de otra instancia

La versión 2.6.17 trae además una corrección de la importación CSV de Pocket. También existe la importación mediante la API de Pocket, con una clave de desarrollador que el administrador introduce en la configuración.

Las importaciones grandes en segundo plano

Para que una importación grande no bloquee la página, wallabag la confía a Redis, que el compose.yaml anterior ya incluye:

  1. En «Internal Settings», sección «Import», active Redis con el valor 1.
  2. Lance la importación desde el menú «Import»: wallabag coloca los artículos en una cola.
  3. Inicie el proceso de trabajo del tipo de importación elegido, por ejemplo pocket_csv; recorre la cola y después sigue a la escucha hasta que lo detenga.
Terminal, en la carpeta del compose.yaml
docker compose run --rm wallabag import pocket_csv

Los demás tipos son pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox y chrome.

El correo: la configuración SMTP

wallabag envía correos para la confirmación de registros, el restablecimiento de contraseñas y los códigos de doble autenticación por correo. Los envía a través del servidor descrito por SYMFONY__ENV__MAILER_DSN, que por defecto es smtp://127.0.0.1.

En un VPS de Simafri, configure un servidor SMTP autenticado, en el puerto 587 o 465: el servicio de correo de su dominio, o un servicio de envío. La documentación da el formato en una sola línea, con usuario, contraseña, servidor y puerto:

compose.yaml, servicio wallabag
      - SYMFONY__ENV__MAILER_DSN=smtp://read%40example.com:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com

Recree después el contenedor con docker compose up -d, y haga una prueba con el enlace «Forgot your password?» de la página de inicio de sesión.

Las copias de seguridad

La página de copias de seguridad de la documentación nombra tres elementos: los ajustes, la base de datos y las imágenes. Con la imagen Docker, este es el lugar de cada uno:

ElementoDónde se encuentraCómo copiarlo
Los ajustesSu compose.yaml: la imagen genera a partir de él parameters.yml en cada inicioUna copia del archivo, guardada en lugar seguro, porque contiene sus secretos
La base de datosEl volumen wallabag-dbUna exportación con mariadb-dump
Las imágenesEl volumen wallabag-images, montado en web/assets/imagesUn archivo comprimido de la carpeta
Terminal, en la carpeta del compose.yaml
docker compose exec -T db sh -c 'exec mariadb-dump -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' > wallabag-$(date +%F).sql
docker compose exec -T wallabag tar -czf - -C /var/www/wallabag/web/assets images > wallabag-images-$(date +%F).tar.gz
cp compose.yaml compose-$(date +%F).yaml

Programe estas copias y envíelas fuera del servidor. Guardados en su disco, estos archivos entran también en sus copias de seguridad nocturnas. Con SQLite, la documentación pide copiar la carpeta data/db.

La restauración

En una instalación nueva, inicie el conjunto con el mismo compose.yaml y después vuelva a cargar la base de datos y las imágenes:

Terminal
docker compose exec -T db sh -c 'exec mariadb -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' < wallabag-2026-11-18.sql
docker compose exec -T wallabag tar -xzf - -C /var/www/wallabag/web/assets < wallabag-images-2026-11-18.tar.gz

Cada usuario puede también exportar sus artículos en JSON, desde la lista «All entries», y volver a importarlos en otra instancia con el importador de wallabag 2.x. Para los administradores, el comando wallabag:export exporta a un archivo los artículos de un usuario.

Las actualizaciones

Con Docker, cambie la etiqueta de la imagen en el compose.yaml, haga una copia de seguridad, y después descargue la nueva imagen y recree el contenedor. El README pide entonces ejecutar las migraciones de la base de datos cuando una versión las incluye:

Terminal, en la carpeta del compose.yaml
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction

Lea la nota de cada versión antes de actualizar: señala los pasos propios de esa versión, como la carpeta que hay que vaciar en la 2.6.16.

Quién hace qué en un VPS administrado

El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; wallabag sigue siendo su software, con sus ajustes y sus artículos.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor convenga a su actividad
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaLa lectura de los registros de su instancia
wallabagSeguimiento proactivo: errores, lentitud, base de datos y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA
Las cuentas y los artículosEl servidor que los soporta, vigilado y con copias de seguridadLos usuarios, los registros, los clientes de la API y las importaciones
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaLas exportaciones propias de wallabag, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl momento del cambio

Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.

wallabag, en un servidor que cuidamos por usted

Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de wallabag, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.

Descubrir los VPS administrados

Preguntas frecuentes

¿wallabag es gratuito?

Sí. wallabag tiene licencia MIT: puede usarlo, modificarlo y redistribuirlo, en una empresa o en cualquier otro ámbito, sin ninguna licencia que comprar, siempre que conserve su aviso de copyright. Queda el coste del servidor que lo ejecuta.

¿Cómo instalar wallabag con Docker Compose?

Parta del compose.yaml de ejemplo de la imagen wallabag/wallabag, con MariaDB y Redis. Defina SYMFONY__ENV__SECRET, las contraseñas y su dirección en SYMFONY__ENV__DOMAIN_NAME, publique el puerto en 127.0.0.1, ejecute docker compose up -d y coloque delante un proxy inverso en HTTPS.

¿Cuáles son los accesos por defecto de wallabag?

La instalación crea un administrador cuyo usuario y contraseña son ambos wallabag. Cambie la contraseña en Config, pestaña Password, y la dirección de correo en User information, antes de abrir la instancia al público.

¿Cómo importar mis artículos de Pocket en wallabag?

Descomprima el ZIP de exportación de Pocket: contiene un archivo CSV como part_000000.csv. En el menú Import, elija Pocket CSV y suba ese archivo. wallabag descarga entonces el contenido de cada artículo; para una exportación grande, active Redis en los ajustes internos.

¿Qué aplicaciones funcionan con wallabag?

El proyecto publica aplicaciones para Android e iOS y la extensión wallabagger para Firefox y Chrome, que se conectan a su instancia por su dirección, sin barra final. iOS y wallabagger necesitan un cliente de la API, creado en API clients management.

¿Por qué los enlaces de wallabag se quedan en http detrás de un proxy?

La imagen lee la cabecera X-Forwarded-Proto para saber que la petición llega por HTTPS. Haga que su proxy la envíe con el valor https, junto con la cabecera Host de su dominio, y ponga la dirección en https:// en SYMFONY__ENV__DOMAIN_NAME.

¿Cómo hacer copia de seguridad de wallabag?

Copie tres elementos: la base de datos, con mariadb-dump para MariaDB, el volumen de imágenes montado en web/assets/images, y su compose.yaml, que contiene los ajustes y los secretos. Envíe estas copias fuera del servidor.

¿Un VPS administrado cubre wallabag?

Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.

Fuentes y documentación oficial

Guías relacionadas

Alojar FreshRSS en un VPS administrado: sus feeds RSS en su propio servidorAlojar FreshRSS en un VPS administrado significa que usted y su equipo leen sus feeds RSS desde una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. FreshRSS es software libre con licencia AGPL-3.0. Esta guía sigue su documentación oficial: la instalación con Docker Compose, HTTPS, la actualización de los feeds, las cuentas y el inicio de sesión, la API para las aplicaciones móviles, la base de datos, las copias de seguridad y las actualizaciones.Copias de seguridad de un VPS: qué comprobar antes de contratarUna oferta de VPS anuncia casi siempre «copias de seguridad incluidas». Detrás de estas palabras puede haber una copia cada noche, guardada fuera de la máquina y restaurada por expertos, o una instantánea situada en el mismo disco que el servidor. Esta guía da las preguntas que marcan la diferencia, lo que significa cada respuesta y la forma de comprobar que una copia de seguridad se restaura.Diferencia entre VPS administrado y no administrado: quién hace quéLa diferencia entre un VPS administrado y uno no administrado se reduce a una pregunta: quién se ocupa del servidor una vez que está en marcha. Sin embargo, «administrado» carece de una definición oficial y, de un proveedor a otro, la palabra va desde una simple instalación del sistema hasta la explotación completa del servidor. Esta guía muestra quién hace qué, tarea por tarea, con el nivel intermedio de la asistencia, y da las preguntas que despejan la ambigüedad antes de firmar.
Contáctenos