Mercurial > kallithea
comparison docs/installation.rst @ 8368:e5ccabbc3cd7 stable
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 |