Show More
@@ -1,75 +1,75 b'' | |||||
1 | .. _troubleshooting: |
|
1 | .. _troubleshooting: | |
2 |
|
2 | |||
3 | =============== |
|
3 | =============== | |
4 | Troubleshooting |
|
4 | Troubleshooting | |
5 | =============== |
|
5 | =============== | |
6 |
|
6 | |||
7 | :Q: **Missing static files?** |
|
7 | :Q: **Missing static files?** | |
8 | :A: Make sure either to set the ``static_files = true`` in the .ini file or |
|
8 | :A: Make sure either to set the ``static_files = true`` in the .ini file or | |
9 | double check the root path for your http setup. It should point to |
|
9 | double check the root path for your http setup. It should point to | |
10 | for example: |
|
10 | for example: | |
11 | ``/home/my-virtual-python/lib/python2.7/site-packages/kallithea/public`` |
|
11 | ``/home/my-virtual-python/lib/python2.7/site-packages/kallithea/public`` | |
12 |
|
12 | |||
13 | | |
|
13 | | | |
14 |
|
14 | |||
15 | :Q: **Can't install celery/rabbitmq?** |
|
15 | :Q: **Can't install celery/rabbitmq?** | |
16 | :A: Don't worry. Kallithea works without them, too. No extra setup is required. |
|
16 | :A: Don't worry. Kallithea works without them, too. No extra setup is required. | |
17 | Try out the great Celery docs for further help. |
|
17 | Try out the great Celery docs for further help. | |
18 |
|
18 | |||
19 | | |
|
19 | | | |
20 |
|
20 | |||
21 | :Q: **Long lasting push timeouts?** |
|
21 | :Q: **Long lasting push timeouts?** | |
22 | :A: Make sure you set a longer timeout in your proxy/fcgi settings. Timeouts |
|
22 | :A: Make sure you set a longer timeout in your proxy/fcgi settings. Timeouts | |
23 | are caused by the http server and not Kallithea. |
|
23 | are caused by the http server and not Kallithea. | |
24 |
|
24 | |||
25 | | |
|
25 | | | |
26 |
|
26 | |||
27 | :Q: **Large pushes timeouts?** |
|
27 | :Q: **Large pushes timeouts?** | |
28 | :A: Make sure you set a proper ``max_body_size`` for the http server. Very often |
|
28 | :A: Make sure you set a proper ``max_body_size`` for the http server. Very often | |
29 | Apache, Nginx, or other http servers kill the connection due to to large |
|
29 | Apache, Nginx, or other http servers kill the connection due to to large | |
30 | body. |
|
30 | body. | |
31 |
|
31 | |||
32 | | |
|
32 | | | |
33 |
|
33 | |||
34 | :Q: **Apache doesn't pass basicAuth on pull/push?** |
|
34 | :Q: **Apache doesn't pass basicAuth on pull/push?** | |
35 | :A: Make sure you added ``WSGIPassAuthorization true``. |
|
35 | :A: Make sure you added ``WSGIPassAuthorization true``. | |
36 |
|
36 | |||
37 | | |
|
37 | | | |
38 |
|
38 | |||
39 | :Q: **Git fails on push/pull?** |
|
39 | :Q: **Git fails on push/pull?** | |
40 | :A: Make sure you're using a WSGI http server that can handle chunked encoding |
|
40 | :A: Make sure you're using a WSGI http server that can handle chunked encoding | |
41 | such as ``waitress`` or ``gunicorn``. |
|
41 | such as ``waitress`` or ``gunicorn``. | |
42 |
|
42 | |||
43 | | |
|
43 | | | |
44 |
|
44 | |||
45 | :Q: **How can I use hooks in Kallithea?** |
|
45 | :Q: **How can I use hooks in Kallithea?** | |
46 | :A: It's easy if they are Python hooks: just use advanced link in |
|
46 | :A: It's easy if they are Python hooks: just use advanced link in | |
47 | hooks section in Admin panel, that works only for Mercurial. If |
|
47 | hooks section in Admin panel, that works only for Mercurial. If | |
48 | you want to use Git hooks, just install th proper one in the repository, |
|
48 | you want to use Git hooks, just install th proper one in the repository, | |
49 | e.g., create a file `/gitrepo/hooks/pre-receive`. You can also use |
|
49 | e.g., create a file `/gitrepo/hooks/pre-receive`. You can also use | |
50 | Kallithea-extensions to connect to callback hooks, for both Git |
|
50 | Kallithea-extensions to connect to callback hooks, for both Git | |
51 | and Mercurial. |
|
51 | and Mercurial. | |
52 |
|
52 | |||
53 | | |
|
53 | | | |
54 |
|
54 | |||
55 | :Q: **Kallithea is slow for me, how can I make it faster?** |
|
55 | :Q: **Kallithea is slow for me, how can I make it faster?** | |
56 | :A: See the :ref:`performance` section. |
|
56 | :A: See the :ref:`performance` section. | |
57 |
|
57 | |||
58 | | |
|
58 | | | |
59 |
|
59 | |||
60 | :Q: **UnicodeDecodeError on Apache mod_wsgi** |
|
60 | :Q: **UnicodeDecodeError on Apache mod_wsgi** | |
61 | :A: Please read: https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/modwsgi/#if-you-get-a-unicodeencodeerror. |
|
61 | :A: Please read: https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/modwsgi/#if-you-get-a-unicodeencodeerror. | |
62 |
|
62 | |||
63 | | |
|
63 | | | |
64 |
|
64 | |||
65 | :Q: **Requests hanging on Windows** |
|
65 | :Q: **Requests hanging on Windows** | |
66 |
:A: Please try out with disabled Antivirus software, there are some known problems with Eset An |
|
66 | :A: Please try out with disabled Antivirus software, there are some known problems with Eset Antivirus. Make sure | |
67 | you have installed the latest Windows patches (especially KB2789397). |
|
67 | you have installed the latest Windows patches (especially KB2789397). | |
68 |
|
68 | |||
69 |
|
69 | |||
70 | .. _virtualenv: http://pypi.python.org/pypi/virtualenv |
|
70 | .. _virtualenv: http://pypi.python.org/pypi/virtualenv | |
71 | .. _python: http://www.python.org/ |
|
71 | .. _python: http://www.python.org/ | |
72 | .. _mercurial: http://mercurial.selenic.com/ |
|
72 | .. _mercurial: http://mercurial.selenic.com/ | |
73 | .. _celery: http://celeryproject.org/ |
|
73 | .. _celery: http://celeryproject.org/ | |
74 | .. _rabbitmq: http://www.rabbitmq.com/ |
|
74 | .. _rabbitmq: http://www.rabbitmq.com/ | |
75 | .. _python-ldap: http://www.python-ldap.org/ |
|
75 | .. _python-ldap: http://www.python-ldap.org/ |
General Comments 0
You need to be logged in to leave comments.
Login now