![(please configure the [header_logo] section in trac.ini)](http://www.wirelessleiden.nl/album/var/resizes/hardware/LeidseLantaarn/LeidseLantaarn.jpg?m=1374663867)
Changes between Version 3 and Version 4 of TracInstall
- Timestamp:
- Oct 1, 2024, 10:09:50 PM (8 weeks ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracInstall
v3 v4 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 What followsare 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 These 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 16 17 To install Trac, the following software packages must be installed: 17 18 … … 20 21 * [https://pypi.org/project/Jinja2 Jinja2], version >= 2.9.3 21 22 22 You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL.23 You also need a database system and the corresponding Python bindings. The database can be either SQLite, PostgreSQL or MySQL. 23 24 24 25 ==== For the SQLite database #ForSQLite … … 49 50 ==== Subversion 50 51 51 [https://subversion.apache.org/ Subversion], 1.14.x or later and the ''' ''corresponding''''' Python bindings.52 [https://subversion.apache.org/ Subversion], 1.14.x or later and the '''corresponding''' Python bindings. 52 53 53 54 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. … … 55 56 {{{#!div style="border: 1pt dotted; margin: 1em" 56 57 **Note:** 57 * Trac '''doesn't''' use [http ://pysvn.tigris.org/PySVN], nor does it work yet with the newer `ctype`-style bindings.58 * Trac '''doesn't''' use [https://pypi.org/project/PySVN PySVN], nor does it work yet with the newer `ctype`-style bindings. 58 59 * If using Subversion, Trac must be installed on the '''same machine'''. Remote repositories are [trac:ticket:493 not supported]. 59 60 }}} … … 70 71 71 72 ==== Web Server 73 72 74 A web server is optional because Trac is shipped with a server included, see the [#RunningtheStandaloneServer Running the Standalone Server] section below. 73 75 … … 78 80 - [http://modpython.org/ mod_python 3.5.0], see TracModPython 79 81 * a [https://fastcgi-archives.github.io FastCGI]-capable web server (see TracFastCgi) 80 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web 81 server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]) 82 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]) 82 83 * Microsoft IIS with FastCGI and a FastCGI-to-WSGI gateway (see [trac:CookBook/Installation/TracOnWindowsIisWfastcgi IIS with FastCGI]) 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 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. 86 85 87 86 ==== Other Python Packages 88 87 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]. 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]. 102 93 * [https://pypi.org/project/passlib passlib] on Windows to decode [TracStandalone#BasicAuthorization:Usingahtpasswdpasswordfile htpasswd formats] other than `SHA-1`. 103 94 * [https://pypi.org/project/pyreadline pyreadline] on Windows for trac-admin [TracAdmin#InteractiveMode command completion]. … … 116 107 117 108 === Using `pip` 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. 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. 121 111 122 112 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: … … 128 118 `pip` supports numerous other install mechanisms. It can be passed the URL of an archive or other download location. Here are some examples: 129 119 130 * Install the latest stable version from a zip archive:131 {{{#!sh132 $ pip install https://download.edgewall.org/trac/Trac-latest.zip133 }}}134 120 * Install the latest development version from a tar archive: 135 121 {{{#!sh … … 138 124 * Install the unreleased 1.4-stable from subversion: 139 125 {{{#!sh 140 $ pip install svn+https://svn.edgewall.org/repos/trac/branches/1. 2-stable126 $ pip install svn+https://svn.edgewall.org/repos/trac/branches/1.4-stable 141 127 }}} 142 128 * Install the latest development preview (//not recommended for production installs//): … … 267 253 Assuming the deployment has been done this way: 268 254 {{{#!sh 269 $ trac-admin /var/trac/<project> deploy /var/www 255 $ trac-admin /var/trac/<project> deploy /var/www/trac 270 256 }}} 271 257 272 258 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: 273 259 {{{#!apache 274 Alias /trac/chrome / path/to/trac/htdocs275 276 <Directory "/ path/to/www/trac/htdocs">260 Alias /trac/chrome /var/www/trac/htdocs 261 262 <Directory "/var/www/trac/htdocs"> 277 263 # For Apache 2.2 278 264 <IfModule !mod_authz_core.c> … … 330 316 == Configuring Authentication 331 317 332 Trac 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.318 Trac 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. 333 319 334 320 The process of adding, removing, and configuring user accounts for authentication depends on the specific way you run Trac.
