| 143 | | Note that in this case you won't have the possibility to run a localized version of Trac; |
| 144 | | 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. |
| 164 | | 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 |
| 165 | | |
| 166 | | 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) |
| 170 | | |
| 171 | | |
| 172 | | === From source |
| 173 | | Of course, using the python-typical setup at the top of the source directory also works. |
| 174 | | |
| 175 | | You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g. Trac-0.12.tar.gz), or you can get the source directly from the repository (see [trac:SubversionRepository] for details). |
| 176 | | |
| 177 | | {{{ |
| 178 | | $ python ./setup.py install |
| 179 | | }}} |
| 180 | | |
| 181 | | ''You'll need root permissions or equivalent for this step.'' |
| 182 | | |
| 183 | | This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory |
| 184 | | of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates. |
| 185 | | |
| 186 | | 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. |
| 187 | | |
| 188 | | 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): |
| 189 | | {{{ |
| 190 | | $ python ./setup.py install |
| 191 | | }}} |
| 192 | | 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`). |
| 193 | | |
| 194 | | === Advanced Options === |
| 195 | | |
| 196 | | To install Trac to a custom location, or find out about other advanced installation options, run: |
| 197 | | {{{ |
| 198 | | easy_install --help |
| 199 | | }}} |
| 200 | | |
| 201 | | Also see [http://docs.python.org/inst/inst.html Installing Python Modules] for detailed information. |
| 202 | | |
| 203 | | Specifically, you might be interested in: |
| 204 | | {{{ |
| 205 | | easy_install --prefix=/path/to/installdir |
| 206 | | }}} |
| 207 | | or, if installing Trac to a Mac OS X system: |
| 208 | | {{{ |
| 209 | | easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages |
| 210 | | }}} |
| 211 | | 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 |
| 212 | | |
| 213 | | 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. |
