troubleshooting.rst 1.88 KB
Newer Older
mathieui's avatar
mathieui committed
1
2
3
4
5
6
7
8
Troubleshooting
===============

I cannot connect.
-----------------

1. Check that you are still connected to the internet.
2. Double-check your credentials.
9
3. Check the :ref:`security settings <security settings>`, maybe your server does not support encryption, or only with weak parameters (like gmail).
mathieui's avatar
mathieui committed
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
4. Maybe your DNS are wrong, try setting the :term:`custom_host` option with the server IP.
5. Overzealous firewall?
6. Running poezio with -d file.txt (debug mode) might reveal your issues.
7. Come see us from the `web client`_ to discuss your issues further.


The outline of poezio is not displayed and unicode characters are broken
------------------------------------------------------------------------
We believe we (or unrelated people) have reported the bug of python3 compiled against the wrong
ncurses to every_ significant_ distribution_ `out there`_, but if there is still
one with it, please go ahead and report it.

Poezio tracebacks with weird encoding errors
--------------------------------------------
Please check your locale for utf-8 compatibility.

Reconnecting sucks
------------------
We know.

Some weird graphical glitches appear once in a blue moon and go away after a refresh
------------------------------------------------------------------------------------
We know.

Python is too heavy
-------------------
We know. It’s too late to change that. If you are running your XMPP client on a toaster,
please try mcabber_.


Other issues
------------
Some things may appear in ``$XDG_DATA_HOME/poezio/errors.log``.


.. _web client: https://jappix.com/?r=poezio@muc.poezio.eu
.. _mcabber: http://mcabber.com/
.. _every: https://bugs.mageia.org/show_bug.cgi?id=2156
.. _significant: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=602720
.. _distribution: https://bugzilla.redhat.com/show_bug.cgi?id=539917
.. _out there: https://bugs.launchpad.net/ubuntu/+source/python3.2/+bug/789732