[[PageOutline(2-3)]] = Trac Download Trac is released under the [TracLicense modified BSD license]. For installation instructions, see TracInstall or the included INSTALL.rst. Please read TracUpgrade if you're upgrading from a previous release. The latest releases of Trac are also available on [https://pypi.python.org/pypi/Trac PyPI]. == Latest Stable Release for the 1.4.x line #Trac14StableRelease Here's the latest and greatest version of Trac. See the [[TracDev/ReleaseNotes/1.4#MaintenanceRelease|release notes]] for details. [[TracDownloads(Trac-latest)]] Again, be sure to read TracInstall and TracUpgrade before installing or upgrading, then proceed by reading the rest of the TracGuide. If you have any trouble, check the TracSupport page which explains how to get help. {{{#!div style="border: 1px dotted #aaa; background: #ffe; width: 26em; margin: auto; padding: 0 2em; font-size: 90%" === About the prerequisites for Trac 1.4.x - Python 2.7 (+[https://pypi.python.org/pypi/setuptools#windows-simplified setuptools]) - Jinja2: [pypi:jinja2 >= 2.9.3] - Genshi: [pypi:genshi >= 0.7] (or [https://genshi.edgewall.org/wiki/Download#LatestRelease:0.7 0.7 win32 installer] available) optional, but needed by many plugins. - Babel: [https://pypi.python.org/pypi/Babel/1.3 1.3] (or [https://babel.edgewall.org/wiki/Download#LatestRelease:0.9.6-2011-03-17 0.9.6], win32 installer available) needed for localizing Trac, otherwise optional. Note that it needs to be installed **before** Trac when installing the latter from source (.gz or .zip). For Windows x64, there are no installers for Genshi and Babel so install them by [TracInstall#Usingpip using pip]. }}} == Older Stable Releases #OlderReleases === Latest Stable Release for the 1.2.x line #Trac12StableRelease Here's the latest version of our previous stable release line (1.2.x) of Trac. See the [[TracDev/ReleaseNotes/1.2|release notes]] for details. This release line is still supported although it is now recommended to upgrade to the [#LatestStableRelease 1.4.x release line]. [[TracDownloads(Trac-latest-1.2, #f6f6f6)]] Again, be sure to read [[1.2/TracInstall]] and [[1.2/TracUpgrade]] before installing or upgrading, then proceed by reading the rest of the [[1.2/TracGuide]]. If you have any trouble, check the TracSupport page which explains how to get help. {{{#!div style="border: 1px dotted #aaa; background: #f6f6f6; width: 26em; margin: auto; padding: 0 2em; font-size: 90%" === About the prerequisites for Trac 1.2.x - Python 2.6 or 2.7 (+[https://pypi.python.org/pypi/setuptools#windows-simplified setuptools]) - Genshi: [https://genshi.edgewall.org/wiki/Download#LatestRelease:0.7 0.7] (or [https://genshi.edgewall.org/wiki/Download#a0.6.1-2013-01-27 0.6.1]) (win32 installer available) - Babel: [https://pypi.python.org/pypi/Babel/1.3 1.3] (or [https://babel.edgewall.org/wiki/Download#LatestRelease:0.9.6-2011-03-17 0.9.6], win32 installer available) needed for localizing Trac, otherwise optional. Note that it needs to be installed **before** Trac when installing the latter from source (.gz or .zip). For Windows x64, there are no installers for Genshi and Babel so install them by [wiki:1.2/TracInstall#Usingeasy_install using easy_install]. }}} === Latest Stable Release for the 1.0.x line #Trac10StableRelease Here's the latest version of our previous stable release line (1.0.x) of Trac. See the [[TracDev/ReleaseNotes/1.0|release notes]] for details. This release line is still supported although it is now recommended to upgrade to the [#LatestStableRelease 1.4.x release line]. [[TracDownloads(Trac-latest-1.0, #f6f6f6)]] Again, be sure to read [[1.0/TracInstall]] and [[1.0/TracUpgrade]] before installing or upgrading, then proceed by reading the rest of the [[1.0/TracGuide]]. If you have any trouble, check the TracSupport page which explains how to get help. {{{#!div style="border: 1px dotted #aaa; background: #f6f6f6; width: 26em; margin: auto; padding: 0 2em; font-size: 90%" === About the prerequisites for Trac 1.0.x - Python 2.5, 2.6 or 2.7 (+[https://pypi.python.org/pypi/setuptools#windows-simplified setuptools]) - Genshi: [https://genshi.edgewall.org/wiki/Download#LatestRelease:0.7 0.7] (or [https://genshi.edgewall.org/wiki/Download#a0.6.1-2013-01-27 0.6.1]) (win32 installer available) - Babel: [https://pypi.python.org/pypi/Babel/1.3 1.3] (or [https://babel.edgewall.org/wiki/Download#LatestRelease:0.9.6-2011-03-17 0.9.6], win32 installer available) needed for localizing Trac, otherwise optional. Note that it needs to be installed **before** Trac when installing the latter from source (.gz or .zip). For Windows x64, there are no installers for Genshi and Babel so install them by [wiki:1.0/TracInstall#Usingeasy_install using easy_install]. }}} === Older Releases Older releases and auxiliary files are archived on the FTP server: * https://download.edgewall.org/trac/ Each release is also tagged in the subversion repository: * https://svn.edgewall.org/repos/trac/tags/ == Latest Development Releases for the 1.5.x line (unstable) #LatestDevRelease The //really// latest and greatest version of Trac. However this is a development release, so a few caveats are in order: - don't expect the level of API or feature stability you'll get from either 1.0.x, 1.2.x or 1.4.x - don't use in production unless you're at ease with backup, upgrade and manual downgrade procedures - don't ship this one in your favorite distribution if you're a Trac package maintainer - the Genshi template engine has been removed [[TracDownloads(Trac-latest-dev, #fda)]] The development releases are not hosted on PyPI, but can be installed using the full URL of the package hosted on download.edgewall.org: {{{#!sh $ pip install https://download.edgewall.org/trac/Trac-latest-dev.tar.gz }}} See the [[TracDev/ReleaseNotes/1.5#DevelopmentRelease|release notes]] for more details. {{{#!div style="border: 1px dotted #aaa; background: #fda; width: 26em; margin: auto; padding: 0 2em; font-size: 90%" === About the prerequisites for Trac 1.5.x - Python 2.7 exclusively (+[https://pypi.python.org/pypi/setuptools#windows-simplified setuptools]) - [https://pypi.python.org/pypi/Jinja Jinja] -- will be installed automatically when installing Trac - [https://pypi.python.org/pypi/Babel Babel] -- needed for localizing Trac, otherwise optional. Note that it needs to be installed **before** Trac when installing the latter from source (.gz or .zip). \\ Versions that should work: [https://babel.edgewall.org/wiki/Download#LatestRelease:0.9.6-2011-03-17 0.9.6], 1.3, 2.6.0 \\ For Windows x64, there are no installers for Babel so install them by [TracInstall#Usingpip using pip]. }}} == Latest Development Source Code We use [https://subversion.apache.org/ Subversion] for source revision control and code sharing, but we also have Git and Mercurial mirrors. The Subversion repository URL for the Trac project is at: https://svn.edgewall.org/repos/trac/ Refer to the TracRepositories page for full details about how to get access to the source. {{{#!htmlcomment I hope this is enough for PyPI: https://svn.edgewall.org/repos/trac/branches/0.11-stable#egg=Trac-0.11-dev 0.11-stable https://svn.edgewall.org/repos/trac/branches/0.12-stable#egg=Trac-0.12-dev 0.12-stable ? }}} === Trac ''1.5dev'' #Tractrunk The latest revision for the upcoming [https://svn.edgewall.org/repos/trac/trunk#egg=Trac-dev next development release] of Trac ([milestone:next-dev-1.5.x]) can be checked out with the following command: {{{#!sh svn co https://svn.edgewall.org/repos/trac/trunk trac }}} (https: also works) Be sure to read [[1.5/TracUpgrade]] and [[1.5/TracInstall]] for the specific installation instructions for this version. === Trac ''1.4-stable'' #Tracstable The latest revision for the upcoming [https://svn.edgewall.org/repos/trac/branches/1.4-stable#egg=Trac-1.4-dev next maintenance release] of Trac ([milestone:next-stable-1.2.x]) can be checked out with the following command: {{{#!sh svn co https://svn.edgewall.org/repos/trac/branches/1.4-stable trac }}} Installation can be performed as usual, using for example the following command: {{{#!sh cd 1.4-stable python setup.py install }}} Alternatively, you can directly "pip install" the latest stable version from the repository: {{{#!sh pip install https://svn.edgewall.org/repos/trac/branches/1.4-stable }}} See the [wiki:TracPlugins#Usingpip] page if you need to install `pip`. Be sure to read TracUpgrade and TracInstall for the specific installation instructions for this version. === Trac ''1.2-stable'' #Tracstable12 The latest revision for the upcoming [https://svn.edgewall.org/repos/trac/branches/1.2-stable#egg=Trac-1.2-dev next maintenance release] of Trac ([milestone:next-stable-1.2.x]) can be checked out using the commands described for [#Tracstable 1.4-stable]. The URL is: {{{ https://svn.edgewall.org/repos/trac/branches/1.2-stable }}} === Installing versions from checkouts It's possible to run Trac directly from a checkout, and that's indeed very useful while developing (see TracDev/DevelopmentEnvironmentSetup). You can also install a development version, either using the normal installation procedure, or by installing it at a specific location. We recommend that you choose some well visible place (e.g. `/opt/trac-1.2dev`), and override the PYTHONPATH environment variable (or !PythonPath path directive for `mod_python`) by ''prepending'' the `/opt/trac-1.2dev/lib/python2.7/site-packages` path (replace 2.7 by the Python version that you actually use). That way, you minimize the risk of interferences with the packaged Trac version you probably already have. {{{#!sh cd 1.2-stable python setup.py install --prefix=/opt/trac-1.2dev }}} then: {{{#!sh export PYTHONPATH=/opt/trac-1.2dev/lib/python2.7/site-packages:$PYTHONPATH }}} or, in your httpd.conf: {{{#!apache ... PythonPath "['/opt/trac-1.2dev/lib/python2.7/site-packages'] + sys.path" ... }}} ---- See also: TracProject, TracGuide.