Troubleshooting

Here you have a quick overview over bugs, and/or errors that might occur during setup.

Locales

This error:

TASK: [mailserver | Set postgres password] ************************************
failed: [**.**.**.**] => {"changed": true, "cmd": ["sudo", "-u", "postgres", "psql", "-d", "postgres", "-c", "ALTER USER postgres with  password '****';"], "delta": "0:00:00.082260", "end": "2014-01-26 14:41:42.101328", "item": "", "rc": 2, "start": "2014-01-26 14:41:42.019068"}
stderr: perl: warning: Setting locale failed.
perl: warning: Please check that your locale settings:
    LANGUAGE = "en_US:en",
    LC_ALL = (unset),
    LC_CTYPE = "de_DE.UTF-8",
    LANG = "C"
    are supported and installed on your system.
perl: warning: Falling back to the standard locale ("C").
psql: could not connect to server: No such file or directory
    Is the server running locally and accepting
    connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

means, that your locales are not configured properly.

To fix this (before running sovereign the first time), run this:

dpkg-reconfigure locales

and configure your locales according to your needs.

If you encountered this error and don't want to restart with a fresh install, do this:

apt-get purge postgresql-9.1

and then:

apt-get install postgresql-9.1

Now run sovereign again, it should work fine now :)

Selfoss

After a fresh installation on Debian Stretch, you may see an error when you load selfoss on news.yourdomain. Checking the apache error logs at /var/log/apache2/selfoss.info-error_log, if you see an error like the below, it would mean that the apache group doesn't have read/write permissions to the selfoss log file at /var/www/selfoss/data/logs/default.log

[Wed Jul 22 05:03:02.110862 2020] [:error] [pid 7115] [client 41.60.232.95:42892] PHP Warning:  fopen(/var/www/selfoss/data/logs/default.log): failed to open stream: Permission denied in /var/www/selfoss/helpers/Logger.php on line 83
[Wed Jul 22 05:03:05.473914 2020] [:error] [pid 7067] [client 41.60.232.95:42896] fopen(/var/www/selfoss/data/logs/default.log): failed to open stream: Permission denied

Running the command chmod g+rw /var/www/selfoss/data/logs/default.log should fix this.

If your error isn't listed here already, just open a new issue and post your fix here (if you already have one).