wallabag #6

Supports: trusty
Add to new model


wallabag is a self hostable application for saving web pages. Unlike other
services, wallabag is free (as in freedom) and open source.



wallabag is a self hostable application for saving web pages. Unlike other
services, wallabag is free (as in freedom) and open source.

With this application you will not miss content anymore. Click, save, read it
when you want. It saves the content you select so that you can read it when you
have time.

(Source: https://www.wallabag.org/)

This Juju charm installs nginx and all the necessary PHP dependencies required
by the Wallabag installation.


Once the charm has installed, you may point a browser to the public IP address
of the deployed service and complete installation. Then your wallabag will be
ready to use.

The default username and password to log in to the web application is
'wallabag'/'wallabag'. Use the 'CONFIG' tab to change your password.

TLS termination

You really should protect your Wallabag server with TLS if you're hosting it on
public networks. For this, use a reverse proxy that supports TLS termination
such as haproxy or
apache2. In such a deployment, you may find
it more economical to place wallabag in an LXC container on the same machine.

For example:

juju deploy wallabag
juju deploy --config my-tls-conf.yaml haproxy
juju add-relation haproxy:reverseproxy wallabag


By default, wallabag uses a local sqlite database. Use a MySQL database for
better performance and scale-out:

juju deploy wallabag
juju deploy mysql
juju add-relation wallabag mysql

Config options

server_name: The public hostname of the web server.

username: and password: determine the login for the default wallabag
account upon installation. Strongly recommended if the initial deployment will be
publicly accessible.


Database migration / recovery

When the wallabag charm forms a new database relation to a database that was
related to wallabag in the past, articles that were saved prior to the relation
changes will not appear in the wallabag application.

They are still stored in the database, however. The problem is that on database
reconfiguration, wallabag has assigned the user a new ID which no longer
matches the old articles.

This can usually be corrected with some UPDATE entries SET user_id = ...
SQL commands on the wallabag database.


  • An action to assist with database migrations and recovery.
  • Support for PostgreSQL.
  • Amulet tests.


(string) listen address
(string) wallabag account password
(int) NGINX listen port
(string) public hostname of server
(string) wallabag account username