Mercurial > kallithea

comparison docs/setup.rst @ 7653:9bae11163c31 stable

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
docs: outline the challenges of specifying a locale for services (Issue #340) Trying to embed the most essential parts of http://blog.dscpl.com.au/2014/09/setting-lang-and-lcall-when-using.html and https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIDaemonProcess.html . (some rewording by Thomas De Schampheleire)
author Mads Kiilerich <mads@kiilerich.com>
date Wed, 01 May 2019 00:57:04 +0200
parents 759d5143042c
children e4f27ab7cbea
comparison
equal deleted inserted replaced
7652:759d5143042c 7653:9bae11163c31
537 application = loadapp('config:' + ini) 537 application = loadapp('config:' + ini)
538 538
539 - Add the necessary ``WSGI*`` directives to the Apache Virtual Host configuration 539 - Add the necessary ``WSGI*`` directives to the Apache Virtual Host configuration
540 file, like in the example below. Notice that the WSGI dispatch script created 540 file, like in the example below. Notice that the WSGI dispatch script created
541 above is referred to with the ``WSGIScriptAlias`` directive. 541 above is referred to with the ``WSGIScriptAlias`` directive.
542 The default locale settings Apache provides for web services are often not
543 adequate, with `C` as the default language and `ASCII` as the encoding.
544 Instead, use the ``lang`` parameter of ``WSGIDaemonProcess`` to specify a
545 suitable locale. See also the :ref:`overview` section and the
546 `WSGIDaemonProcess documentation`_.
547
542 Apache will by default run as a special Apache user, on Linux systems 548 Apache will by default run as a special Apache user, on Linux systems
543 usually ``www-data`` or ``apache``. If you need to have the repositories 549 usually ``www-data`` or ``apache``. If you need to have the repositories
544 directory owned by a different user, use the user and group options to 550 directory owned by a different user, use the user and group options to
545 WSGIDaemonProcess to set the name of the user and group. 551 WSGIDaemonProcess to set the name of the user and group.
546 552
547 Once again, check that all paths are correctly specified. 553 Once again, check that all paths are correctly specified.
548 554
549 .. code-block:: apache 555 .. code-block:: apache
550 556
551 WSGIDaemonProcess kallithea processes=5 threads=1 maximum-requests=100 \ 557 WSGIDaemonProcess kallithea processes=5 threads=1 maximum-requests=100 \
552 python-home=/srv/kallithea/venv 558 python-home=/srv/kallithea/venv lang=C.UTF-8
553 WSGIProcessGroup kallithea 559 WSGIProcessGroup kallithea
554 WSGIScriptAlias / /srv/kallithea/dispatch.wsgi 560 WSGIScriptAlias / /srv/kallithea/dispatch.wsgi
555 WSGIPassAuthorization On 561 WSGIPassAuthorization On
556 562
557 Or if using a dispatcher WSGI script with proper virtualenv activation: 563 Or if using a dispatcher WSGI script with proper virtualenv activation:
558 564
559 .. code-block:: apache 565 .. code-block:: apache
560 566
561 WSGIDaemonProcess kallithea processes=5 threads=1 maximum-requests=100 567 WSGIDaemonProcess kallithea processes=5 threads=1 maximum-requests=100 lang=en_US.utf8
562 WSGIProcessGroup kallithea 568 WSGIProcessGroup kallithea
563 WSGIScriptAlias / /srv/kallithea/dispatch.wsgi 569 WSGIScriptAlias / /srv/kallithea/dispatch.wsgi
564 WSGIPassAuthorization On 570 WSGIPassAuthorization On
565 571
566 572
581 .. _Celery documentation: http://docs.celeryproject.org/en/latest/getting-started/index.html 587 .. _Celery documentation: http://docs.celeryproject.org/en/latest/getting-started/index.html
582 .. _RabbitMQ: http://www.rabbitmq.com/ 588 .. _RabbitMQ: http://www.rabbitmq.com/
583 .. _Redis: http://redis.io/ 589 .. _Redis: http://redis.io/
584 .. _mercurial-server: http://www.lshift.net/mercurial-server.html 590 .. _mercurial-server: http://www.lshift.net/mercurial-server.html
585 .. _PublishingRepositories: https://www.mercurial-scm.org/wiki/PublishingRepositories 591 .. _PublishingRepositories: https://www.mercurial-scm.org/wiki/PublishingRepositories
592 .. _WSGIDaemonProcess documentation: https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIDaemonProcess.html