selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Wallabag logo

Self-host Wallabag

2.6.15

Read-it-later archive that strips articles to clean text

ReleaseOpen SourceMIT
docker run -v wallabag-data:/var/www/wallabag/data -v wallabag-images:/var/www/wallabag/web/assets/images -p 8080:80 -e "SYMFONY__ENV__DOMAIN_NAME=http://localhost:8080" wallabag/wallabag
Updatedlast week
LanguagePHP
Setup difficultyModerate
MobileNative app
Stars
13 057
Port
80 (HTTP port the wallabag container listens on (mapped to host 8080 in the documented docker run example).)
Docker
wallabag/wallabag
List of saved articles with the reading controlsThe account configuration screen with its settings tabs

What is Wallabag?

wallabag is an open-source read-it-later web application: you save a page, it extracts the article text so pop-ups and distractions are gone, and you can come back to it later in the browser, on a phone, through a feed reader or on an e-reader device. Articles can be tagged, annotated, shared and downloaded, and existing archives can be pulled in from Pocket, Instapaper, Readability, Pinboard, elCurator or an older wallabag instance. Users get their own RSS feeds of saved items (item count controlled by the rss_limit parameter), and a REST API secured with OAuth tokens is what the official Android and iOS apps and the wallabagger browser extension use. Administratively it is a PHP/Symfony application: install it with the provided Makefile plus Composer against a MySQL, PostgreSQL or SQLite database, upload the packaged build to shared hosting, or run the wallabag/wallabag container. Public registration, email confirmation and two-factor authentication are switched by parameters in parameters.yml, and mail delivery is configured through mailer_dsn. The same code powers the vendor's paid hosting service wallabag.it, while the self-hosted edition is MIT licensed.

Wallabag alternatives

All self-hosted alternatives to Pocket → All self-hosted alternatives to Omnivore →

Should you self-host Wallabag?

Wallabag scores 73/100 on selfhost.directory (how scoring works) and ranks #4 of 46 in Bookmarks & Link Sharing. It has 13 057 GitHub stars, +61 in the last 30 days.

It shipped 1 stable release in the past year. The latest, 2.6.15, came out on 28 October 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in PHP.

Its closest alternative on selfhost.directory is LinkWarden (79/100, 20 347 stars). It scores higher overall, so compare the two before you pick. See Wallabag vs LinkWarden side by side.

Features

  • Article annotations
  • Article content extraction
  • Automatic tagging rules
  • Bulk import from other services
  • Estimated reading time
  • Multi-user accounts
  • Read-it-later saving
  • REST API with OAuth
  • RSS feeds of saved articles
  • Translated interface
  • Two-factor authentication

Wallabag README

wallabag

Important

The name of this project is wallabag — all lowercase, always. Not "Wallabag", not "WallaBag", not any other variation. Just plain, humble, all-lowercase wallabag 😉

CI Matrix Donation Status Translation status License

wallabag is a web application allowing you to save web pages for later reading. Click, save and read it when you want. It extracts content so that you won't be distracted by pop-ups and cie.

You can install it on your own server, or you can create an account on wallabag.it.

How to install Wallabag

Install Wallabag with Docker

docker run \
  -v wallabag-data:/var/www/wallabag/data \
  -v wallabag-images:/var/www/wallabag/web/assets/images \
  -p 8080:80 -e "SYMFONY__ENV__DOMAIN_NAME=http://localhost:8080" \
  wallabag/wallabag

This example uses a SQLite backend; default username and password are wallabag:wallabag. Production compose files live in the wallabag/docker repository.

How to configure Wallabag

  • SYMFONY__ENV__DOMAIN_NAMEEnvironment variable used by the official Docker image to set the instance URL (example value http://localhost:8080).
  • database_driver_class~Should be used only for PostgreSQL 10 with Wallabag\CoreBundle\Doctrine\DBAL\Driver\CustomPostgreSQLDriver
  • database_host127.0.0.1host of your database (usually localhost or 127.0.0.1)
  • database_port~port of your database (you can leave ~ to use the default one)
  • database_namesymfonyname of your database

Wallabag releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How do I fix the "failed to load external entity" error during installation?

Patch web/app.php by adding libxml_disable_entity_loader(false); on line 5 - it comes from a Doctrine/PHP bug.

Why has SQLite support been dropped?

It was dropped in June 2017 because SQLite made database migrations painful; MySQL became the default database, though SQLite is still fine for development.

Clicking the activation link says "The user with confirmation token does not exist".

Either the account was already activated, or the link in the activation email is wrong.

How do I reset a forgotten password?

Use the "Forgot your password?" link on the login page and submit your email or username to receive a reset link.

Why am I not receiving my activation email?

Check the address, then your spam folder; if it is still missing, make sure a mail transfer agent is installed and configured, allowing SMTP through the firewall (and the SELinux httpd_can_sendmail boolean).

During the installation, I got the error "Error Output: sh: 1: @post-cmd: not found" — what does it mean?

Reinstall Composer: the message usually points at a broken Composer installation.

More in Bookmarks & Link Sharing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…