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.
Por Simon Vasconcelos Lee
Publicado el 18 de noviembre de 202614 minutos de lectura
wallabag/wallabag, MariaDB, Redis y el puerto web publicado en 127.0.0.1 detrás de un proxy inverso en HTTPS.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.X-Forwarded-Proto: https: así sabe wallabag que sus visitantes llegan por HTTPS.compose.yaml, y actualice cambiando la etiqueta de la imagen y ejecutando las migraciones.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.
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.
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:
memory_limit en 256 MB por defecto desde su versión 2.6.16, y la variable PHP_MEMORY_LIMIT lo modifica.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.
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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: el ejemplo del repositorio publica el puerto 80 del contenedor sin dirección, y Docker lo abre entonces en todas las direcciones del servidor. Publicado en local, solo es accesible a través del proxy inverso.MYSQL_ROOT_PASSWORD, la imagen crea la base de datos y su usuario, y después ejecuta wallabag:install, que crea las tablas y la cuenta wallabag. La línea wallabag is ready! del registro marca el final.wallabag; el servicio db la conserva.wallabag-db contiene la base de datos, wallabag-images las imágenes de los artículos. El ejemplo de la documentación de instalación también usa volúmenes con nombre.redis.2.6.17, 2.6, 2 y latest. Una versión completa le permite elegir el momento de cada actualización.Para comprobar que la aplicación responde, consulte la ruta que usa la comprobación de estado de la imagen:
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.
/var/www/wallabag/data/db/wallabag.sqlite; en ese caso, monte un volumen en /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, el puerto 5432, y POSTGRES_USER y POSTGRES_PASSWORD para que la imagen cree la base de datos. La versión 2.6.15 de la imagen corrige la propiedad de la base de datos con PostgreSQL 15 y posteriores.POPULATE_DATABASE=False y después inicialícela una vez con docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. El README pide ejecutar este comando como nobody, para que ningún archivo quede en propiedad de root.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:
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 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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag y wallabag.| Variable | Valor por defecto | Lo que hace |
|---|---|---|
SYMFONY__ENV__SECRET | Una cadena pública, la misma para todas las instancias | Aporta entropía a las operaciones de seguridad: la documentación la quiere única para su instancia |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | La dirección completa de su instancia, sin barra final |
SYMFONY__ENV__FOSUSER_REGISTRATION | false en la imagen Docker | Abre o cierra el registro público |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Envía un correo de confirmación por cada registro |
SYMFONY__ENV__LOCALE | en | El idioma por defecto de la instancia, como es |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | El 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.
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.
X-Forwarded-Proto: el proxy debe enviarla con el valor https.Host: su nombre de dominio, para que las redirecciones de la aplicación apunten a él.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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;
}
}
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.
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.
| Herramienta | Lo que hace | Lo que necesita |
|---|---|---|
| Aplicación para Android | Sincroniza sus listas de artículos y las muestra en su teléfono | La 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 iOS | Muestra sus artículos en iPhone y iPad | La dirección, un identificador y un secreto de cliente de la API, su usuario y su contraseña |
| Extensión wallabagger, para Firefox y Chrome | Guarda la página abierta, con sus etiquetas, como favorita o archivada | La 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 marcadores | Nada: se arrastra desde la página «Howto» |
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:
| Servicio | El archivo que hay que aportar |
|---|---|
| Pocket, exportación CSV | El ZIP de exportación de Pocket, una vez descomprimido: un archivo CSV con un nombre como part_000000.csv |
| Pocket, exportación HTML | El archivo HTML de la exportación antigua de Pocket, como ril_export.html |
| Instapaper | El CSV de la página de ajustes de Instapaper |
| Omnivore | Los archivos metadata_x_to_y.json de la exportación descomprimida, uno por uno |
| Pinboard, Delicious | Su exportación JSON |
| Shaarli | Su exportación HTML |
| Firefox, Chrome | La copia de seguridad JSON de los marcadores de Firefox, o el archivo Bookmarks de Chrome |
| Readability, elCurator | Su exportación |
| wallabag 1.x o 2.x | La 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.
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.pocket_csv; recorre la cola y después sigue a la escucha hasta que lo detenga.docker compose run --rm wallabag import pocket_csv
Los demás tipos son pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox y chrome.
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:
- 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
@ se convierte en %40. Si un carácter codificado impide el inicio, la documentación propone duplicar el signo de porcentaje: %%40.FROM_EMAIL es el remitente de todos los correos de wallabag, TWOFACTOR_SENDER el de los códigos de doble autenticación. Use una dirección de su dominio desde la que su servidor SMTP acepte enviar.:465 al final de la línea.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.
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:
| Elemento | Dónde se encuentra | Cómo copiarlo |
|---|---|---|
| Los ajustes | Su compose.yaml: la imagen genera a partir de él parameters.yml en cada inicio | Una copia del archivo, guardada en lugar seguro, porque contiene sus secretos |
| La base de datos | El volumen wallabag-db | Una exportación con mariadb-dump |
| Las imágenes | El volumen wallabag-images, montado en web/assets/images | Un archivo comprimido de la carpeta |
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.
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:
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.
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:
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction
var/import, y su nota de versión pide vaciar la antigua carpeta web/uploads/import. En este compose.yaml, esa carpeta está dentro del contenedor: el que se crea a partir de la nueva imagen arranca sin ella.make update, que en las instancias con la 2.6.15 o anteriores elegía una versión alfa publicada esa misma mañana. Para una instalación Git que se haya quedado bloqueada, su nota de versión da la reparación: git checkout 2.6.17 --force y después make update.make update, que ejecuta también las migraciones y vacía la caché.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.
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.
| Tema | Nuestros equipos | Usted |
|---|---|---|
| El servidor | Actualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidas | El momento que mejor convenga a su actividad |
| La supervisión | Servidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamada | La lectura de los registros de su instancia |
| wallabag | Seguimiento proactivo: errores, lentitud, base de datos y espacio en disco detectados, corrección recomendada | Su instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA |
| Las cuentas y los artículos | El servidor que los soporta, vigilado y con copias de seguridad | Los usuarios, los registros, los clientes de la API y las importaciones |
| Las copias de seguridad | Cada noche, cifradas y guardadas fuera de la máquina; restauración incluida | Las exportaciones propias de wallabag, y la petición de restauración, cuando la necesite |
| La migración | Su servidor actual migrado, gratis | El 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Hablemos de su proyecto
Díganos en pocas palabras lo que necesita: le respondemos rápidamente.
¡Gracias! Su solicitud ha sido enviada. Le responderemos en breve.
¿Prefiere el correo? Escríbanos a support@simafri.com.