Mercurial > kallithea

comparison docs/installation.rst @ 8368:e5ccabbc3cd7 stable

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
release: merge default to stable for 0.6.0
author Thomas De Schampheleire <thomas.de_schampheleire@nokia.com>
date Sat, 02 May 2020 21:20:43 +0200
parents 01aca0a4f876
children fc54d9d65006
comparison
equal deleted inserted replaced
8320:b1b1f69b1f28 8368:e5ccabbc3cd7
33 Git and development packages for the database of your choice. 33 Git and development packages for the database of your choice.
34 34
35 For Debian and Ubuntu, the following command will ensure that a reasonable 35 For Debian and Ubuntu, the following command will ensure that a reasonable
36 set of dependencies is installed:: 36 set of dependencies is installed::
37 37
38 sudo apt-get install build-essential git python-pip python-virtualenv libffi-dev python-dev 38 sudo apt-get install build-essential git libffi-dev python3-dev
39 39
40 For Fedora and RHEL-derivatives, the following command will ensure that a 40 For Fedora and RHEL-derivatives, the following command will ensure that a
41 reasonable set of dependencies is installed:: 41 reasonable set of dependencies is installed::
42 42
43 sudo yum install gcc git python-pip python-virtualenv libffi-devel python-devel 43 sudo yum install gcc git libffi-devel python3-devel
44 44
45 .. _installation-source: 45 .. _installation-source:
46 46
47 47
48 Installation from repository source 48 Installation from repository source
49 ----------------------------------- 49 -----------------------------------
50 50
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, follow the instructions below:: 52 repository, follow the instructions below::
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 virtualenv ../kallithea-venv 56 python3 -m venv ../kallithea-venv
57 . ../kallithea-venv/bin/activate 57 . ../kallithea-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 python2 setup.py compile_catalog # for translation of the UI 60 python3 setup.py compile_catalog # for translation of the UI
61 61
62 You can now proceed to :ref:`setup`. 62 You can now proceed to :ref:`setup`.
63 63
64 .. _installation-virtualenv: 64 .. _installation-virtualenv:
65 65
66 66
67 Installing a released version in a virtualenv 67 Installing a released version in a virtualenv
68 --------------------------------------------- 68 ---------------------------------------------
69 69
70 It is highly recommended to use a separate virtualenv_ for installing Kallithea. 70 It is highly recommended to use a separate virtualenv for installing Kallithea.
71 This way, all libraries required by Kallithea will be installed separately from your 71 This way, all libraries required by Kallithea will be installed separately from your
72 main Python installation and other applications and things will be less 72 main Python installation and other applications and things will be less
73 problematic when upgrading the system or Kallithea. 73 problematic when upgrading the system or Kallithea.
74 An additional benefit of virtualenv_ is that it doesn't require root privileges. 74 An additional benefit of virtualenv is that it doesn't require root privileges.
75 75
76 - Assuming you have installed virtualenv_, create a new virtual environment 76 - Assuming you have installed virtualenv, create a new virtual environment
77 for example, in `/srv/kallithea/venv`, using the virtualenv command:: 77 for example, in `/srv/kallithea/venv`, using the venv command::
78 78
79 virtualenv /srv/kallithea/venv 79 python3 -m venv /srv/kallithea/venv
80 80
81 - Activate the virtualenv_ in your current shell session and make sure the 81 - Activate the virtualenv in your current shell session and make sure the
82 basic requirements are up-to-date by running:: 82 basic requirements are up-to-date by running::
83 83
84 . /srv/kallithea/venv/bin/activate 84 . /srv/kallithea/venv/bin/activate
85 pip install --upgrade pip setuptools 85 pip install --upgrade pip setuptools
86 86
131 To install as a regular user in ``~/.local``, you can use:: 131 To install as a regular user in ``~/.local``, you can use::
132 132
133 pip install --user kallithea 133 pip install --user kallithea
134 134
135 You can now proceed to :ref:`setup`. 135 You can now proceed to :ref:`setup`.
136
137
138 .. _virtualenv: http://pypi.python.org/pypi/virtualenv