# Wallabag Read-It-Later

> Wallabag self-hosted read-it-later application for saving articles.

- Category: Productivity & Collaboration
- Difficulty: intermediate
- Components: wallabag, postgres, redis
- Tags: wallabag, read-later, articles, pocket-alternative, archive
- Source: https://docker.recipes/productivity/wallabag-readlater

## Overview

Wallabag is a self-hosted, open-source read-it-later application that serves as a privacy-focused alternative to commercial services like Pocket or Instapaper. Originally launched in 2013, Wallabag allows users to save articles, web pages, and content for offline reading while providing full control over their reading data. The application features a clean, responsive interface, content extraction capabilities, and cross-platform synchronization without relying on third-party services that monetize user reading habits.

This deployment combines Wallabag with PostgreSQL for robust article metadata storage and Redis for high-performance session management and caching. PostgreSQL's full-text search capabilities enable fast article searching across saved content, while its JSONB support efficiently stores extracted article metadata and user annotations. Redis accelerates the application by caching frequently accessed articles, managing user sessions, and handling background job queues for content processing tasks like article extraction and thumbnail generation.

This stack is ideal for privacy-conscious individuals, families, and small organizations who want to maintain their own reading archive without dependence on commercial platforms. The combination provides enterprise-grade reliability for personal use, making it perfect for power readers, researchers, journalists, and anyone building a permanent knowledge base from web content.

## Features

- Full-text article extraction with readability parsing that strips ads and formatting
- PostgreSQL-backed tagging system with advanced search across article content and metadata
- Redis-accelerated content processing queue for batch article imports and exports
- Multi-format export capabilities including EPUB, PDF, and JSON for article portability
- Annotation and highlighting system with PostgreSQL storage for permanent note-keeping
- RSS feed generation for saved articles with Redis caching for performance
- User management system with PostgreSQL-stored reading statistics and preferences
- Mobile-responsive interface with Redis session storage for cross-device continuity

## Use cases

- Personal reading archive for researchers collecting articles across multiple domains
- Family sharing setup for homeschooling parents organizing educational content
- Small newsroom or blog team collaborating on article research and fact-checking
- Digital minimalist setup replacing multiple commercial read-later service subscriptions
- Academic research environment for literature review and source material organization
- Corporate knowledge management for teams tracking industry news and competitive intelligence
- Self-hosted alternative for users concerned about reading habit privacy and data ownership

## Prerequisites

- Minimum 2GB RAM (1GB for PostgreSQL, 512MB for Redis, 512MB for Wallabag application)
- Docker and Docker Compose installed with support for multi-container networking
- Available ports 8080 for web interface access and internal PostgreSQL/Redis communication
- Basic understanding of environment variables for database credentials and domain configuration
- Familiarity with PostgreSQL backup procedures for article data protection
- Knowledge of reverse proxy setup if exposing Wallabag to external network access

## docker-compose.yml

```yaml
services:
  wallabag:
    image: wallabag/wallabag:latest
    container_name: wallabag
    environment:
      - SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql
      - SYMFONY__ENV__DATABASE_HOST=postgres
      - SYMFONY__ENV__DATABASE_PORT=5432
      - SYMFONY__ENV__DATABASE_NAME=wallabag
      - SYMFONY__ENV__DATABASE_USER=${POSTGRES_USER}
      - SYMFONY__ENV__DATABASE_PASSWORD=${POSTGRES_PASSWORD}
      - SYMFONY__ENV__DOMAIN_NAME=${DOMAIN_NAME}
      - SYMFONY__ENV__SERVER_NAME="Wallabag"
      - SYMFONY__ENV__FOSUSER_REGISTRATION=false
      - SYMFONY__ENV__REDIS_HOST=redis
    volumes:
      - wallabag_data:/var/www/wallabag/data
      - wallabag_images:/var/www/wallabag/web/assets/images
    ports:
      - "8080:80"
    depends_on:
      - postgres
      - redis
    networks:
      - wallabag-network

  postgres:
    image: postgres:16-alpine
    container_name: wallabag-db
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=wallabag
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - wallabag-network

  redis:
    image: redis:7-alpine
    container_name: wallabag-redis
    networks:
      - wallabag-network

volumes:
  wallabag_data:
  wallabag_images:
  postgres_data:

networks:
  wallabag-network:
    driver: bridge
```

## .env

```bash
# Wallabag
POSTGRES_USER=wallabag
POSTGRES_PASSWORD=wallabag_password
DOMAIN_NAME=http://localhost:8080
```

## Usage notes

- UI at http://localhost:8080
- Default login: wallabag / wallabag
- Browser extensions available
- Mobile apps for iOS/Android
- API for integrations

## Troubleshooting

- Database connection failed errors: Verify POSTGRES_USER and POSTGRES_PASSWORD match between wallabag and postgres services
- Articles not saving or extraction failing: Check Redis container health and network connectivity between wallabag and redis services
- Slow article search performance: Increase PostgreSQL shared_buffers and work_mem settings, ensure full-text search indexes are built
- Session timeouts or login issues: Restart Redis container and verify Redis host configuration in Wallabag environment variables
- Import/export operations hanging: Monitor Redis memory usage and increase maxmemory setting if processing large article batches
- 403 Forbidden on article access: Check DOMAIN_NAME environment variable matches your access URL and Wallabag base_url configuration

