ScriptsApr 16, 2026·3 min read

Wallabag — Self-Hosted Read-It-Later App

Wallabag is a self-hosted read-it-later application that saves web articles for offline reading with tagging, annotations, and full-text search.

TL;DR
Wallabag saves web articles for offline reading with tagging, annotations, and full-text search.
§01

What it is

Wallabag is a self-hosted read-it-later application. It saves web articles, strips away ads and clutter, and stores the clean content for offline reading. Wallabag supports tagging, annotations, full-text search, RSS feed export, and mobile apps for iOS and Android. It is the self-hosted alternative to Pocket and Instapaper.

Wallabag is for privacy-conscious readers and information workers who want to save articles without relying on third-party services that track reading habits.

The project is actively maintained with regular releases and a growing user community. Documentation covers common use cases, and the open-source nature means you can inspect the source code, contribute fixes, and adapt the tool to your specific requirements.

§02

How it saves time or tokens

Browser bookmarks pile up and become unusable. Pocket and Instapaper are third-party services with tracking and potential shutdowns. Wallabag gives you a private article archive that you control, with full-text search to find anything you saved. The browser extensions and mobile apps make saving articles a one-click action.

§03

How to use

  1. Deploy Wallabag via Docker or install on a PHP-capable server.
  2. Add the browser extension to save articles with one click.
  3. Read saved articles in the web UI or mobile app, online or offline.
§04

Example

# Deploy via Docker
docker run -d --name wallabag \
  -p 8080:80 \
  -e SYMFONY__ENV__DOMAIN_NAME=http://localhost:8080 \
  -e SYMFONY__ENV__DATABASE_DRIVER=pdo_sqlite \
  wallabag/wallabag

# Default credentials: wallabag / wallabag
# Open http://localhost:8080

# Import from Pocket
# Settings > Import > Pocket > Connect and import
§05

Related on TokRepo

§06

Common pitfalls

  • Some websites block Wallabag's content extraction. The built-in reader uses site-config rules, but paywalled or JavaScript-heavy sites may save incomplete content.
  • The SQLite database is fine for personal use but slows down with thousands of articles. Switch to PostgreSQL or MySQL for larger collections.
  • Mobile apps sync over the Wallabag API. If your server uses a self-signed SSL certificate, the mobile apps will refuse to connect unless you configure the certificate trust.

Before adopting this tool, evaluate whether it fits your team's existing workflow. Read the official documentation thoroughly, and start with a small proof-of-concept rather than a full migration. Community forums, GitHub issues, and Stack Overflow are valuable resources when you encounter edge cases not covered in the documentation.

Frequently Asked Questions

Can I import from Pocket or Instapaper?+

Yes. Wallabag has built-in importers for Pocket, Instapaper, Readability, Pinboard, and browser bookmarks. The import process handles thousands of articles in one batch.

Does Wallabag have mobile apps?+

Yes. Wallabag has official apps for iOS and Android that sync with your server. Articles are downloaded for offline reading, so you can read without an internet connection.

How does Wallabag extract article content?+

Wallabag uses a content extraction engine based on site-config rules that strip ads, navigation, and clutter from web pages. It produces clean, readable text similar to browser reader modes.

Can I annotate articles in Wallabag?+

Yes. Wallabag supports inline annotations and highlighting. You can add notes to specific passages in saved articles and search across your annotations.

Is Wallabag free?+

Yes. Wallabag is free and open source under the MIT license. You can self-host it at no cost. A managed hosting option (wallabag.it) is also available for a small fee.

Citations (3)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets