mirror of
https://github.com/samsonjs/vdirsyncer.git
synced 2026-03-26 09:05:50 +00:00
977ba4c285
As usual for Armin, excellent software with excellent design, but basically no maintenance.
65 lines
2.4 KiB
ReStructuredText
65 lines
2.4 KiB
ReStructuredText
==========================
|
|
Support and Known Problems
|
|
==========================
|
|
|
|
For any unanswered questions or problems, `open an issue on GitHub
|
|
<https://github.com/untitaker/vdirsyncer/issues/new>`_ or `contact me directly
|
|
<https://unterwaditzer.net>`_.
|
|
|
|
Error messages
|
|
--------------
|
|
|
|
- **[Errno 185090050] _ssl.c:343: error:0B084002:x509 certificate
|
|
routines:X509_load_cert_crl_file:system lib**
|
|
|
|
vdirsyncer cannot find the path to your certificate bundle, you need to
|
|
supply it as a parameter to ``verify`` in storage configuration, e.g.::
|
|
|
|
verify = /usr/share/ca-certificates/cacert.org/cacert.org_root.crt
|
|
|
|
- **ImportError: No module named packages.urllib3.poolmanager**
|
|
|
|
This happens if the requests package was installed via Debian's package
|
|
manager, see :gh:`82`. You have two options for solving this problem:
|
|
|
|
- Upgrade your installation of the Debian requests package to at least
|
|
version ``2.4.3-1``.
|
|
|
|
- Install vdirsyncer in a virtualenv, see :ref:`manual-installation`.
|
|
|
|
|
|
.. _manual-installation:
|
|
|
|
Manual installation
|
|
-------------------
|
|
|
|
If your distribution doesn't provide a package for vdirsyncer, you still can
|
|
use Python's package manager "pip". First, you'll have to check that a
|
|
compatible version of Python (2.7+ or 3.3+) and the corresponding pip package
|
|
are installed. On Linux systems, using the distro's package manager is the best
|
|
way to do this.
|
|
|
|
The easiest way to install vdirsyncer at this point would be to run::
|
|
|
|
pip install --user vdirsyncer
|
|
|
|
This method has a major flaw though: Pip doesn't keep track of the files it
|
|
installs. Vdirsyncer's files would be located somewhere in
|
|
``~/.local/lib/python*``, but you can't possibly know which packages were
|
|
installed as dependencies of vdirsyncer and which ones were not, should you
|
|
decide to uninstall it. In other words, using pip that way would pollute your
|
|
home directory.
|
|
|
|
But there is a way to install Python software without scattering stuff across
|
|
your filesystem: virtualenv_. There are a lot of resources on how to use it,
|
|
the simplest possible way would look something like::
|
|
|
|
virtualenv ~/vdirsyncer_env
|
|
~/vdirsyncer_env/bin/pip install vdirsyncer
|
|
alias vdirsyncer="~/vdirsyncer_env/bin/vdirsyncer
|
|
|
|
You'll have to put the last line into your ``.bashrc`` or ``.bash_profile``.
|
|
The main advantage is that you can delete the ``~/vdirsyncer_env`` folder to
|
|
uninstall vdirsyncer.
|
|
|
|
.. _virtualenv: https://virtualenv.readthedocs.org/
|