Edgewall Software

Changes between Version 7 and Version 8 of 1.5/TracInstall


Ignore:
Timestamp:
Apr 27, 2022, 9:15:15 AM (2 months ago)
Author:
figaro
Comment:

Tigris.org discontinued

Legend:

Unmodified
Added
Removed
Modified
  • 1.5/TracInstall

    v7 v8  
    99If you're interested in contributing new translations for other languages or enhancing the existing translations, please have a look at [trac:wiki:TracL10N TracL10N].
    1010
    11 What follows are generic instructions for installing and setting up Trac. While you may find instructions for installing Trac on specific systems at [trac:TracInstallPlatforms TracInstallPlatforms], please '''first read through these general instructions''' to get a good understanding of the tasks involved.
     11These are generic instructions for installing and setting up Trac. While you may find instructions for installing Trac on specific systems at [trac:TracInstallPlatforms TracInstallPlatforms], please '''first read through these general instructions''' to get a good understanding of the tasks involved.
    1212
    1313[[PageOutline(2-3,Installation Steps,inline)]]
     
    1515== Dependencies
    1616=== Mandatory Dependencies
     17
    1718To install Trac, the following software packages must be installed:
    1819
     
    5051==== Subversion
    5152
    52 [https://subversion.apache.org/ Subversion], 1.14.x or later and the '''''corresponding''''' Python bindings.
     53[https://subversion.apache.org/ Subversion], 1.14.x or later and the '''corresponding''' Python bindings.
    5354
    5455There are [https://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. See [trac:TracSubversion#GettingSubversion getting Subversion] for more information.
     
    5657{{{#!div style="border: 1pt dotted; margin: 1em"
    5758**Note:**
    58 * Trac '''doesn't''' use [http://pysvn.tigris.org/ PySVN], nor does it work yet with the newer `ctype`-style bindings.
     59* Trac '''doesn't''' use [https://pypi.org/project/PySVN PySVN], nor does it work yet with the newer `ctype`-style bindings.
    5960* If using Subversion, Trac must be installed on the '''same machine'''. Remote repositories are [trac:ticket:493 not supported].
    6061}}}
     
    7172
    7273==== Web Server
     74
    7375A web server is optional because Trac is shipped with a server included, see the [#RunningtheStandaloneServer Running the Standalone Server] section below.
    7476
     
    7981   - [http://modpython.org/ mod_python 3.5.0], see TracModPython
    8082 * a [https://fastcgi-archives.github.io FastCGI]-capable web server (see TracFastCgi)
    81  * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web
    82    server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp])
     83 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp])
    8384 * Microsoft IIS with FastCGI and a FastCGI-to-WSGI gateway (see [trac:CookBook/Installation/TracOnWindowsIisWfastcgi IIS with FastCGI])
    84  * a CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script
    85    is highly discouraged''', better use one of the previous options.
    86 
     85 * a CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script is highly discouraged''', better use one of the previous options.
    8786
    8887==== Other Python Packages
    8988
    90  * [http://babel.pocoo.org Babel], version >= 2.2,
    91    needed for localization support
    92  * [http://pytz.sourceforge.net pytz] to get a complete list of time zones,
    93    otherwise Trac will fall back on a shorter list from
    94    an internal time zone implementation. Installing Babel
    95    will install pytz.
    96  * [http://docutils.sourceforge.net docutils],
    97    version >= 0.14, for WikiRestructuredText.
    98  * [http://pygments.org Pygments], version >= 1.0,
    99    for [TracSyntaxColoring syntax highlighting].
    100  * [https://pypi.org/project/textile Textile],
    101    version >= 2.3,
    102    for rendering the [https://github.com/textile/python-textile Textile markup language].
     89 * [http://babel.pocoo.org Babel], version >= 2.2, needed for localization support
     90 * [http://pytz.sourceforge.net pytz] to get a complete list of time zones, otherwise Trac will fall back on a shorter list from an internal time zone implementation. Installing Babel will install pytz.
     91 * [http://docutils.sourceforge.net docutils], version >= 0.14, for WikiRestructuredText.
     92 * [http://pygments.org Pygments], version >= 1.0, for [TracSyntaxColoring syntax highlighting].
     93 * [https://pypi.org/project/textile Textile], version >= 2.3, for rendering the [https://github.com/textile/python-textile Textile markup language].
    10394 * [https://pypi.org/project/passlib passlib] on Windows to decode [TracStandalone#BasicAuthorization:Usingahtpasswdpasswordfile htpasswd formats] other than `SHA-1`.
    10495 * [https://pypi.org/project/pyreadline pyreadline] on Windows for trac-admin [TracAdmin#InteractiveMode command completion].
     
    117108
    118109=== Using `pip`
    119 `pip` is the modern Python package manager and is included in Python distributions. `pip` will automatically
    120 resolve the //required// dependencies (Jinja2 and
    121 setuptools) and download the latest packages from pypi.org.
     110
     111`pip` is the modern Python package manager and is included in Python distributions. `pip` will automatically resolve the //required// dependencies (Jinja2 and setuptools) and download the latest packages from pypi.org.
    122112
    123113You can also install directly from a source package. You can obtain the source in a tar or zip from the [trac:TracDownload] page. After extracting the archive, change to the directory containing `setup.py` and run:
     
    327317== Configuring Authentication
    328318
    329 Trac uses HTTP authentication. You'll need to configure your webserver to request authentication when the `.../login` URL is hit (the virtual path of the "login" button). Trac will automatically pick the `REMOTE_USER` variable up after you provide your credentials. Therefore, all user management goes through your web server configuration. Please consult the documentation of your web server for more info.
     319Trac uses HTTP authentication. You'll need to configure your web server to request authentication when the `.../login` URL is hit (the virtual path of the "login" button). Trac will automatically pick the `REMOTE_USER` variable up after you provide your credentials. Therefore, all user management goes through your web server configuration. Please consult the documentation of your web server for more info.
    330320
    331321The process of adding, removing, and configuring user accounts for authentication depends on the specific way you run Trac.