Mercurial > kallithea

comparison docs/installation.rst @ 8634:6bab917402b4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
docs: when using venv with a clone, recommend using 'venv' as location Avoid having the odd inconsistent location ../kallithea-venv to care about. For good or bad, this might change how it is feasible to grep. I usually make sure to only search tracked files: grep Foo `hg mani`
author Mads Kiilerich <mads@kiilerich.com>
date Mon, 24 Aug 2020 15:13:52 +0200
parents c354d1a7537f
children c819a1e9103b
comparison
equal deleted inserted replaced
8633:c354d1a7537f 8634:6bab917402b4
51 To install Kallithea in a virtualenv using the stable branch of the development 51 To install Kallithea in a virtualenv using the stable branch of the development
52 repository, use the following commands in your bash shell:: 52 repository, use the following commands in your bash shell::
53 53
54 hg clone https://kallithea-scm.org/repos/kallithea -u stable 54 hg clone https://kallithea-scm.org/repos/kallithea -u stable
55 cd kallithea 55 cd kallithea
56 python3 -m venv ../kallithea-venv 56 python3 -m venv venv
57 . ../kallithea-venv/bin/activate 57 . venv/bin/activate
58 pip install --upgrade pip setuptools 58 pip install --upgrade pip setuptools
59 pip install --upgrade -e . 59 pip install --upgrade -e .
60 python3 setup.py compile_catalog # for translation of the UI 60 python3 setup.py compile_catalog # for translation of the UI
61 61
62 .. note:: 62 .. note::
79 main Python installation and other applications and things will be less 79 main Python installation and other applications and things will be less
80 problematic when upgrading the system or Kallithea. 80 problematic when upgrading the system or Kallithea.
81 An additional benefit of virtualenv is that it doesn't require root privileges. 81 An additional benefit of virtualenv is that it doesn't require root privileges.
82 82
83 - Don't install as root - install as a dedicated user like ``kallithea``. 83 - Don't install as root - install as a dedicated user like ``kallithea``.
84 If necessary, create the top directory for the virtualenv (like
85 ``/srv/kallithea/venv``) as root and assign ownership to the user.
84 86
85 - Create a new virtual environment, for example in ``/srv/kallithea/venv``, 87 - Create a new virtual environment, for example in ``/srv/kallithea/venv``,
86 specifying the right Python binary:: 88 specifying the right Python binary::
87 89
88 python3 -m venv /srv/kallithea/venv 90 python3 -m venv /srv/kallithea/venv