Changes between Version 6 and Version 7 of TracInstall
- Timestamp:
- Sep 8, 2024, 12:14:12 PM (3 months ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracInstall
v6 v7 8 8 If you're interested in contributing new translations for other languages or enhancing the existing translations, please have a look at [trac:wiki:TracL10N TracL10N]. 9 9 10 Theseare 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.10 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. 11 11 12 12 [[PageOutline(2-3,Installation Steps,inline)]] … … 14 14 == Dependencies 15 15 === Mandatory Dependencies 16 17 16 To install Trac, the following software packages must be installed: 18 17 … … 21 20 * [https://pypi.org/project/Jinja2 Jinja2], version >= 2.9.3 22 21 23 You also need a database system and the corresponding Python bindings. The database can be either SQLite, PostgreSQL or MySQL.22 You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL. 24 23 25 24 ==== For the SQLite database #ForSQLite … … 50 49 ==== Subversion 51 50 52 [https://subversion.apache.org/ Subversion], 1.14.x or later and the ''' corresponding''' Python bindings.51 [https://subversion.apache.org/ Subversion], 1.14.x or later and the '''''corresponding''''' Python bindings. 53 52 54 53 There are [https://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. See [trac:TracSubversion#GettingSubversion getting Subversion] for more information. … … 56 55 {{{#!div style="border: 1pt dotted; margin: 1em" 57 56 **Note:** 58 * Trac '''doesn't''' use [http s://pypi.org/project/PySVNPySVN], nor does it work yet with the newer `ctype`-style bindings.57 * Trac '''doesn't''' use [http://pysvn.tigris.org/ PySVN], nor does it work yet with the newer `ctype`-style bindings. 59 58 * If using Subversion, Trac must be installed on the '''same machine'''. Remote repositories are [trac:ticket:493 not supported]. 60 59 }}} … … 71 70 72 71 ==== Web Server 73 74 72 A web server is optional because Trac is shipped with a server included, see the [#RunningtheStandaloneServer Running the Standalone Server] section below. 75 73 … … 80 78 - [http://modpython.org/ mod_python 3.5.0], see TracModPython 81 79 * a [https://fastcgi-archives.github.io FastCGI]-capable web server (see TracFastCgi) 82 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]) 80 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web 81 server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]) 83 82 * 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 is highly discouraged''', better use one of the previous options. 83 * a CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script 84 is highly discouraged''', better use one of the previous options. 85 85 86 86 87 ==== Other Python Packages 87 88 88 * [http://babel.pocoo.org Babel], version >= 2.2, needed for localization support 89 * [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. 90 * [http://docutils.sourceforge.net docutils], version >= 0.14, for WikiRestructuredText. 91 * [http://pygments.org Pygments], version >= 1.0, for [TracSyntaxColoring syntax highlighting]. 92 * [https://pypi.org/project/textile Textile], version >= 2.3, for rendering the [https://github.com/textile/python-textile Textile markup language]. 89 * [http://babel.pocoo.org Babel], version >= 2.2, 90 needed for localization support 91 * [http://pytz.sourceforge.net pytz] to get a complete list of time zones, 92 otherwise Trac will fall back on a shorter list from 93 an internal time zone implementation. Installing Babel 94 will install pytz. 95 * [http://docutils.sourceforge.net docutils], 96 version >= 0.14, for WikiRestructuredText. 97 * [http://pygments.org Pygments], version >= 1.0, 98 for [TracSyntaxColoring syntax highlighting]. 99 * [https://pypi.org/project/textile Textile], 100 version >= 2.3, 101 for rendering the [https://github.com/textile/python-textile Textile markup language]. 93 102 * [https://pypi.org/project/passlib passlib] on Windows to decode [TracStandalone#BasicAuthorization:Usingahtpasswdpasswordfile htpasswd formats] other than `SHA-1`. 94 103 * [https://pypi.org/project/pyreadline pyreadline] on Windows for trac-admin [TracAdmin#InteractiveMode command completion]. … … 107 116 108 117 === Using `pip` 109 110 `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. 118 `pip` is the modern Python package manager and is included in Python distributions. `pip` will automatically 119 resolve the //required// dependencies (Jinja2 and 120 setuptools) and download the latest packages from pypi.org. 111 121 112 122 You 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: … … 118 128 `pip` supports numerous other install mechanisms. It can be passed the URL of an archive or other download location. Here are some examples: 119 129 130 * Install the latest stable version from a zip archive: 131 {{{#!sh 132 $ pip install https://download.edgewall.org/trac/Trac-latest.zip 133 }}} 120 134 * Install the latest development version from a tar archive: 121 135 {{{#!sh … … 124 138 * Install the unreleased 1.4-stable from subversion: 125 139 {{{#!sh 126 $ pip install svn+https://svn.edgewall.org/repos/trac/branches/1. 4-stable140 $ pip install svn+https://svn.edgewall.org/repos/trac/branches/1.2-stable 127 141 }}} 128 142 * Install the latest development preview (//not recommended for production installs//): … … 253 267 Assuming the deployment has been done this way: 254 268 {{{#!sh 255 $ trac-admin /var/trac/<project> deploy /var/www /trac269 $ trac-admin /var/trac/<project> deploy /var/www 256 270 }}} 257 271 258 272 Add the following snippet to Apache configuration, changing paths to match your deployment. The snippet must be placed ''before'' the `ScriptAlias` or `WSGIScriptAlias` directive, because those directives map all requests to the Trac application: 259 273 {{{#!apache 260 Alias /trac/chrome / var/www/trac/htdocs261 262 <Directory "/ var/www/trac/htdocs">274 Alias /trac/chrome /path/to/trac/htdocs 275 276 <Directory "/path/to/www/trac/htdocs"> 263 277 # For Apache 2.2 264 278 <IfModule !mod_authz_core.c> … … 316 330 == Configuring Authentication 317 331 318 Trac uses HTTP authentication. You'll need to configure your web 332 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. 319 333 320 334 The process of adding, removing, and configuring user accounts for authentication depends on the specific way you run Trac.
