wallabag #6

  • By cmars
  • Latest version (#6)
  • trusty
  • Stable
  • Edge

Description

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


Wallabag

Overview

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.

Deployment

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

Databases

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.

Bugs

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.

TODO

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

Configuration

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