TiloBox
Back to directory
wallabag project preview

wallabag

A self-hosted read-it-later application for saving, tagging, searching, and reading cleaned web articles offline.

LicenseMIT
GitHub stars12.9k
Last commit1 weeks ago
Tags6 topics
Read LaterPrivacySelf HostedOpen SourcePhpArticles
Overview

Why consider wallabag?

wallabag is a self-hostable open-source read-it-later web application built with Symfony and PHP that extracts article content for distraction-free reading. It gives users complete ownership of their personal reading archive with cross-platform apps, tagging rules, and third-party import tools.

Guided learning

Learn wallabag by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

3 min read 5 sections
In this guide5 sections

Core Overview and Architecture

As detailed in the official source code on GitHub, wallabag is a self hostable application for saving web pages: Save and classify articles. Built on top of the Symfony PHP framework, the application empowers individuals and organizations to store online reading material securely on their own private infrastructure without depending on proprietary hosted services.

According to the project README available at GitHub README, wallabag is a web application allowing you to save web pages for later reading. When you archive a link, the extraction engine strips away obtrusive scripts, popups, and sidebar clutter, leaving behind clean typography and readable text that can be formatted to match your personal viewing preferences.

As highlighted on the official homepage at wallabag.org, wallabag extracts the content you care about, keeps it in your own archive, and lets you read comfortably from your browser, phone, RSS reader, or e-reader. Readers can synchronize their saved library across mobile applications, dedicated e-ink readers, browser extensions, or syndicated RSS feeds while maintaining central data ownership.

Automated Organization and Tagging Rules

To keep large article collections structured without tedious manual categorization, administrators can establish automated filtering criteria. As explained in the official user guide at Tagging Rules Documentation, These are rules used by wallabag to automatically tag new entries. Each time a new entry is added, all the tagging rules will be processed to add the tags that would match. Users can define rules based on estimated reading time, domain names, content patterns, or title keywords.

Deployment and Installation on Dedicated Servers

Deploying wallabag on a dedicated server with command-line access offers maximum performance and customization. As outlined in the official administrator guide at Installation Documentation, To install wallabag itself, you must run the following commands:

bash
1git clone https://github.com/wallabag/wallabag.git
2cd wallabag && make install

For environments where Composer or Git are not available, a pre-assembled distribution bundle is also distributed. As noted in the official setup guide at Installation Documentation, We provide a package with all dependencies inside. The default configuration uses MySQL for the database. You can retrieve and extract this static release package directly on your server:

bash
1wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package

Developer API and Authentication

Developers and third-party client authors can interface directly with the REST API using token-based authentication. According to the official developer documentation at OAuth API Guide, For each API call, you'll need an access token. You can exchange your application client credentials and user login for an access token via an HTTP POST request:

bash
1http POST http://localhost:8000/oauth/v2/token \
2 grant_type=password \
3 client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc \
4 client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 \
5 username=wallabag \
6 password=wallabag

Ongoing Maintenance and Releases

The software continues to receive active maintenance and community contributions. In the recent release notes at Release 2.6.14, recent updates include Add annotations filter to entries API endpoint as well as reading time calculations and performance refinements. Distributed under the permissive terms documented in COPYING.md, wallabag provides an enduring, private alternative to commercial bookmarking services.

Related tools

More options with a similar category or technology profile.

wallabag FAQs

wallabag is listed as a Content Cms tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository and official website for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

wallabag is listed under the MIT license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

wallabag is listed as an alternative to Pocket. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.