@@ -138,15 +138,17 @@ installed.
directory with Python files and everything else that is needed.
(``pip install kallithea`` from a source tree will do pretty much the same
but build the Kallithea package itself locally instead of downloading it.)
.. note::
Kallithea includes front-end code that needs to be processed first.
The tool npm_ is used to download external dependencies and orchestrate the
processing. The ``npm`` binary must thus be available.
Kallithea includes front-end code that needs to be processed to prepare
static files that can be served at run time and used on the client side. The
tool npm_ is used to download external dependencies and orchestrate the
processing. The ``npm`` binary must thus be available at install time but is
not used at run time.
Web server
----------
Kallithea is (primarily) a WSGI_ application that must be run from a web
@@ -51,13 +51,15 @@ path to the root).
.. note:: the given path for Mercurial_ repositories **must** be write
accessible for the application. It's very important since
the Kallithea web interface will work without write access,
but when trying to do a push it will fail with permission
denied errors unless it has write access.
Finally, prepare the front-end by running::
Finally, the front-end files must be prepared. This requires ``npm`` version 6
or later, which needs ``node.js`` (version 12 or later). Prepare the front-end
by running::
kallithea-cli front-end-build
You are now ready to use Kallithea. To run it simply execute::
gearbox serve -c my.ini
Status change: