| 6 | | Since version 0.12, Trac can also be localized, and there's probably a translation available for your language. If you want to be able to use the Trac interface in other languages, then make sure you have installed the optional package [#OtherPythonPackages Babel]. Pay attention to the extra steps for localization support in the [#InstallingTrac Installing Trac] section below. Lacking Babel, you will only get the default english version, as usual. |
| 7 | | |
| 8 | | If you're interested in contributing new translations for other languages or enhance the existing translations, then please have a look at ["TracL10N"]. |
| | 6 | Since version 0.12, Trac can also be localized, and there's probably a translation available for your language. If you want to be able to use the Trac interface in other languages, then make sure you **first** have installed the optional package [#OtherPythonPackages Babel]. Lacking Babel, you will only get the default english version, as usual. If you install Babel later on, you will need to re-install Trac. |
| | 7 | |
| | 8 | If you're interested in contributing new translations for other languages or enhance the existing translations, then please have a look at [trac:wiki:TracL10N TracL10N]. |
| 41 | | SQLite 2.x is no longer supported. For SQLite 3.x, the pysqlite 1.1.x |
| 42 | | bindings are also no longer supported, use pysqlite 2.x. |
| 43 | | |
| 44 | | See additional information in [trac:PySqlite PySqlite]. |
| | 40 | To install SQLite, your system may require the development headers. Without these you will get various GCC related errors when attempting to build: |
| | 41 | |
| | 42 | {{{ |
| | 43 | $ apt-get install libsqlite3-dev |
| | 44 | }}} |
| | 45 | |
| | 46 | SQLite 2.x is no longer supported, and neither is !PySqlite 1.1.x. |
| | 47 | |
| | 48 | A known bug !PySqlite versions 2.5.2-4 prohibits upgrade of trac databases |
| | 49 | from 0.11.x to 0.12. Please use versions 2.5.5 and newer or 2.5.1 and |
| | 50 | older. See [trac:#9434] for more detail. |
| | 51 | |
| | 52 | See additional information in [trac:PySqlite]. |
| 69 | | * [http://subversion.apache.org/ Subversion], 1.5.x or 1.6.x and the '''''corresponding''''' Python bindings. Older versions starting from 1.0, like 1.2.4, 1.3.2 or 1.4.2, etc. should still work. For troubleshooting information, check the [trac:TracSubversion#Troubleshooting TracSubversion] page. |
| 70 | | |
| 71 | | There are [http://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. Note that Trac '''doesn't''' use [http://pysvn.tigris.org/ PySVN], neither does it work yet with the newer `ctype`-style bindings |
| | 77 | * [http://subversion.apache.org/ Subversion], 1.5.x or 1.6.x and the '''''corresponding''''' Python bindings. Older versions starting from 1.4.0, etc. should still work. For troubleshooting information, check the [trac:TracSubversion#Troubleshooting TracSubversion] page. Versions prior to 1.4.0 won't probably work since trac uses svn core functionality (e.g. svn_path_canonicalize) that is not implemented in the python swig wrapper in svn <= 1.3.x (although it exists in the svn lib itself). |
| | 78 | |
| | 79 | There are [http://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. (Good luck finding precompiled SWIG bindings for any Windows package at that listing. TracSubversion points you to [http://alagazam.net Algazam], which works for me under Python 2.6.) |
| | 80 | |
| | 81 | Note that Trac '''doesn't''' use [http://pysvn.tigris.org/ PySVN], neither does it work yet with the newer `ctype`-style bindings. [Is there a ticket for implementing ctype bindings?] |
| 132 | | Note that in this case you won't have the possibility to run a localized version of Trac; |
| 133 | | either use a released version or install from source |
| | 145 | |
| | 146 | - upgrade to the latest trunk development version (0.13dev): |
| | 147 | {{{ |
| | 148 | easy_install -U Trac==dev |
| | 149 | }}} |
| | 150 | |
| | 151 | For upgrades, reading the TracUpgrade page is mandatory, of course. |
| | 152 | |
| | 153 | === From source |
| | 154 | If you want more control, you can download the source in archive form, or do a checkout from one of the official [[Trac:TracRepositories|source code repositories]]. |
| | 155 | |
| | 156 | Be sure to have the prerequisites already installed. You can also obtain the Genshi and Babel source packages from http://www.edgewall.org and follow for them a similar installation procedure, or you can just easy_install those, see [#Usingeasy_install above]. |
| | 157 | |
| | 158 | Once you've unpacked the Trac archive or performed the checkout, move in the top-level folder and do: |
| | 159 | {{{ |
| | 160 | $ python ./setup.py install |
| | 161 | }}} |
| | 162 | |
| | 163 | ''You'll need root permissions or equivalent for this step.'' |
| | 164 | |
| | 165 | This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory |
| | 166 | of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates. |
| | 167 | |
| | 168 | The script will also install the [wiki:TracAdmin trac-admin] command-line tool, used to create and maintain [wiki:TracEnvironment project environments], as well as the [wiki:TracStandalone tracd] standalone server. |
| | 169 | |
| | 170 | If you install from source and want to make Trac available in other languages, make sure Babel is installed. Only then, perform the `install` (or simply redo the `install` once again afterwards if you realize Babel was not yet installed): |
| | 171 | {{{ |
| | 172 | $ python ./setup.py install |
| | 173 | }}} |
| | 174 | Alternatively, you can do a `bdist_egg` and copy the .egg from dist/ to the place of your choice, or you can create a Windows installer (`bdist_wininst`). |
| | 175 | |
| | 176 | === Advanced Options === |
| | 177 | |
| | 178 | To install Trac to a custom location, or find out about other advanced installation options, run: |
| | 179 | {{{ |
| | 180 | easy_install --help |
| | 181 | }}} |
| | 182 | |
| | 183 | Also see [http://docs.python.org/inst/inst.html Installing Python Modules] for detailed information. |
| | 184 | |
| | 185 | Specifically, you might be interested in: |
| | 186 | {{{ |
| | 187 | easy_install --prefix=/path/to/installdir |
| | 188 | }}} |
| | 189 | or, if installing Trac to a Mac OS X system: |
| | 190 | {{{ |
| | 191 | easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages |
| | 192 | }}} |
| | 193 | Note: If installing on Mac OS X 10.6 running {{{ easy_install http://svn.edgewall.org/repos/trac/trunk }}} will install into {{{ /usr/local }}} and {{{ /Library/Python/2.6/site-packages }}} by default |
| | 194 | |
| | 195 | The above will place your `tracd` and `trac-admin` commands into `/usr/local/bin` and will install the Trac libraries and dependencies into `/Library/Python/2.5/site-packages`, which is Apple's preferred location for third-party Python application installations. |
| 153 | | pip will automatically resolve all dependencies (like Genshi, pygments, etc.) and download the latest packages on pypi.python.org and create a self contained installation in /opt/user/trac |
| 154 | | |
| 155 | | All commands (tracd, trac-admin) are available in /opt/user/trac/bin . This can also be leveraged for mod_python (using PythonHandler directive) and mod_wsgi (using WSGIDaemonProcess directive) |
| | 215 | pip will automatically resolve all dependencies (like Genshi, pygments, etc.) and download the latest packages on pypi.python.org and create a self contained installation in /opt/user/trac . |
| | 216 | |
| | 217 | All commands (tracd, trac-admin) are available in /opt/user/trac/bin. This can also be leveraged for mod_python (using !PythonHandler directive) and mod_wsgi (using WSGIDaemonProcess directive) |
| 159 | | |
| 160 | | |
| 161 | | === From source |
| 162 | | Of course, using the python-typical setup at the top of the source directory also works. |
| 163 | | |
| 164 | | You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g. Trac-0.12rc1.tar.gz), or you can get the source directly from the repository (see Trac:SubversionRepository for details). |
| 165 | | |
| 166 | | {{{ |
| 167 | | $ python ./setup.py install |
| 168 | | }}} |
| 169 | | |
| 170 | | ''You'll need root permissions or equivalent for this step.'' |
| 171 | | |
| 172 | | This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory |
| 173 | | of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates. |
| 174 | | |
| 175 | | The script will also install the [wiki:TracAdmin trac-admin] command-line tool, used to create and maintain [wiki:TracEnvironment project environments], as well as the [wiki:TracStandalone tracd] standalone server. |
| 176 | | |
| 177 | | If you install from source and want to make Trac available in other languages, make sure Babel is installed. Only then, perform the `install` (or simply redo the `install` once again afterwards if you realize Babel was not yet installed): |
| 178 | | {{{ |
| 179 | | $ python ./setup.py install |
| 180 | | }}} |
| 181 | | Alternatively, you can do a `bdist_egg` and copy the .egg from dist/ to the place of your choice, or you can create a Windows installer (`bdist_wininst`). |
| 182 | | |
| 183 | | === Advanced Options === |
| 184 | | |
| 185 | | To install Trac to a custom location, or find out about other advanced installation options, run: |
| 186 | | {{{ |
| 187 | | easy_install --help |
| 188 | | }}} |
| 189 | | |
| 190 | | Also see [http://docs.python.org/inst/inst.html Installing Python Modules] for detailed information. |
| 191 | | |
| 192 | | Specifically, you might be interested in: |
| 193 | | {{{ |
| 194 | | easy_install --prefix=/path/to/installdir |
| 195 | | }}} |
| 196 | | or, if installing Trac to a Mac OS X system: |
| 197 | | {{{ |
| 198 | | easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages |
| 199 | | }}} |
| 200 | | Note: If installing on Mac OS X 10.6 running {{{ easy_install http://svn.edgewall.org/repos/trac/trunk }}} will install into {{{ /usr/local }}} and {{{ /Library/Python/2.6/site-packages }}} by default |
| 201 | | |
| 202 | | The above will place your `tracd` and `trac-admin` commands into `/usr/local/bin` and will install the Trac libraries and dependencies into `/Library/Python/2.5/site-packages`, which is Apple's preferred location for third-party Python application installations. |
