# wallabag

> A self-hosted read-it-later app for clutter-free articles.

- Page: https://cgt.octabyte.io/templates/wallabag/
- Category: Reading & bookmarks
- Replaces: Pocket and Instapaper
- Ease of use: Easy. Sign in as wallabag with the password Cloudgate shows, then add the browser extension or phone app to start saving articles.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: People who save articles to read later and want a clean reader and e-reader downloads
- Official website: https://wallabag.org
- Documentation: https://doc.wallabag.org
- Source code: https://github.com/wallabag/wallabag
- Last updated: 2026-11-20

## What is wallabag?

wallabag is a self-hosted read-it-later app: save web articles from your browser or phone and read them later without ads, or on an e-reader.

wallabag is a free, open-source, self-hosted read-it-later app that saves web articles and shows them without ads or clutter, in place of Pocket or Instapaper. You save a page from your browser or phone, and wallabag keeps its text and pictures so you can read it later on any device.

You sort what you save with tags and the Unread, Starred and Archive lists, highlight passages, and add notes. Tagging rules can file new articles for you, and any list can be downloaded as an ePUB or PDF file for an e-reader. A bookshop owner, for example, could save reviews and publisher news during the week, tag them by genre, and read the week's batch on a Kobo on Sunday.

wallabag has apps for Android and iPhone and a browser extension for Firefox and Chrome. It imports Pocket and Instapaper exports, Omnivore, Pinboard and browser bookmarks, so you can bring your old reading list with you.

Cloudgate installs wallabag on a server Cloudgate provides or one you connect, with its database, and gives it a secure web address. You sign in as wallabag with the password Cloudgate created, then add accounts for anyone else who reads with you.

## What you can do with wallabag

- **Save an article in one click**: Use the browser extension, the phone apps, a bookmark button or the + button, and wallabag keeps the article's text and pictures.
- **Read without clutter**: wallabag strips out ads, pop-ups and menus, and shows how many minutes each article takes to read.
- **Sort with tags and lists**: Keep articles in Unread, Starred and Archive, tag them, and search or filter by site, date or reading time.
- **Tag new articles for you**: Tagging rules file articles as they arrive, for example "short read" for anything under three minutes.
- **Highlight and add notes**: Select a passage in any saved article to highlight it and write a note beside it.
- **Read on an e-reader**: Download one article or a whole list as an ePUB or PDF file for your Kobo, Kindle or tablet.
- **Bring your Pocket articles**: Import from a Pocket or Instapaper export, Omnivore, Pinboard, or your Firefox and Chrome bookmarks.

## Replaces Pocket and Instapaper

wallabag does the same job as Pocket and Instapaper. Here is what changes when you switch.

### What you gain

- Your reading list lives on your own server, so no company can shut it down as Mozilla did with Pocket
- Search, tags, highlights and e-reader downloads are free, with no premium plan
- No ads or tracking in the reader
- Several people can each have their own account on one wallabag

### What is different

- Imported Pocket and Instapaper articles are fetched again from the original websites, so pages that have gone may come in empty
- Some websites, such as paywalled news sites, do not save cleanly
- The design is plainer than Pocket's, with no read-aloud or recommendations
- Email features such as password reset need mail settings added first

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=wallabag

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. wallabag itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up wallabag.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is wallabag free?

Yes. wallabag is free, open-source software under the MIT licence, and the self-hosted app has no paid features. Its creator also runs wallabag.it, a paid hosted service, which you do not need when you host wallabag yourself.

### Is wallabag a good alternative to Pocket?

Yes. wallabag does the job Pocket did, saving articles from your browser or phone to read later without clutter, and it imports a Pocket export file. Mozilla shut Pocket down in July 2025; a self-hosted wallabag cannot be shut down by someone else.

### Can I import my articles from Pocket or Instapaper?

Yes. wallabag imports the CSV file from a Pocket export, an Instapaper CSV export, Omnivore and Pinboard exports, and Firefox or Chrome bookmark files. It fetches each article's text again from the original website, so articles from sites that no longer exist may arrive as a link only.

### How do I sign in to wallabag the first time?

Sign in with the username wallabag and the password Cloudgate generated, shown on the app's variables page in Cloudgate. The template replaces wallabag's well-known default password on the first start, so the usual wallabag/wallabag login does not work. Public sign-up is off; you add other people in Users management.

### Is there a wallabag phone app and browser extension?

Yes. wallabag has apps for Android and iPhone and a browser extension for Firefox and Chrome. Each one connects to your wallabag's web address, so an article you save on your phone is waiting in your browser too.

### Can I read wallabag articles on a Kindle or Kobo?

Yes. You can download any article, or a whole list such as Unread, as an ePUB or PDF file and copy it to your e-reader. wallabag also offers Atom feeds of your lists for feed readers.

### Should I choose wallabag or Karakeep?

Choose wallabag if you mainly save articles to read, highlight and send to an e-reader. Choose Karakeep if you also want to keep links, notes, images and PDFs together with optional AI tagging. Both are free, self-hosted and import from Pocket.

### Do I need technical skills to run wallabag?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up wallabag and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for wallabag?

No. When you deploy wallabag, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
