wallabag
A self-hosted read-it-later application for saving, tagging, searching, and reading cleaned web articles offline.
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.
Learn wallabag by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
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:
git clone https://github.com/wallabag/wallabag.gitcd wallabag && make installFor 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:
wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-packageDeveloper 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:
http POST http://localhost:8000/oauth/v2/token \ grant_type=password \ client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc \ client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 \ username=wallabag \ password=wallabagOngoing 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.
Mayan EDMS
Free Open Source Electronic Document Management System with digital signatures.
Docspell
Personal document organizer that automates OCR, tagging, and metadata extraction.
Gollum
Simple, Git-powered wiki system that powers GitHub Wikis.
Docsify
A magical documentation site generator that parses Markdown on the fly.