Changeset - 7982eac0703d
[Not reviewed]
default
0 1 0
Mads Kiilerich (mads) - 5 years ago 2020-09-03 15:05:44
mads@kiilerich.com
Grafted from: 8d0d71623d01
docs: drop documentation for installing without virtualenv

Installing globally as root require an unjustified trust in our build/install
process ... and makes it very hard to uninstall or clean up.

Installing as a user is slightly better but also more error-prone and not
recommended.

Those who really want to do it and know how to do it also don't need this
description.
1 file changed with 6 insertions and 27 deletions:
0 comments (0 inline, 0 general)
docs/installation.rst
Show inline comments
 
@@ -19,12 +19,12 @@ The following describes three different 
 
  installations side by side or remove it entirely by just removing the
 
  virtualenv directory) and does not require root privileges.
 

	
 
- :ref:`installation-without-virtualenv`: The alternative method of installing
 
  a Kallithea release is using standard pip. The package will be installed in
 
  the same location as all other Python packages you have ever installed. As a
 
  result, removing it is not as straightforward as with a virtualenv, as you'd
 
  have to remove its dependencies manually and make sure that they are not
 
  needed by other packages.
 
- Kallithea can also be installed with plain pip - globally or with ``--user``
 
  or similar. The package will be installed in the same location as all other
 
  Python packages you have ever installed. As a result, removing it is not as
 
  straightforward as with a virtualenv, as you'd have to remove its
 
  dependencies manually and make sure that they are not needed by other
 
  packages. We recommend using virtualenv.
 

	
 
Regardless of the installation method you may need to make sure you have
 
appropriate development packages installed, as installation of some of the
 
@@ -125,27 +125,6 @@ An additional benefit of virtualenv is t
 

	
 
You can now proceed to :ref:`install-front-end`.
 

	
 
.. _installation-without-virtualenv:
 

	
 

	
 
Installing a released version without virtualenv
 
------------------------------------------------
 

	
 
For installation without virtualenv, 'just' use::
 

	
 
    pip install kallithea
 

	
 
Note that this method requires root privileges and will install packages
 
globally without using the system's package manager.
 

	
 
To install as a regular user in ``~/.local``, you can use::
 

	
 
    pip install --user kallithea
 

	
 
You can now proceed to :ref:`install-front-end`.
 

	
 
.. _install-front-end:
 

	
 

	
 
Prepare front-end files
 
-----------------------
0 comments (0 inline, 0 general)