setuptools is a Python module that helps to compile, distribute and install Python packages by packaging them into "egg"s. Eggs contain additional information to process dependencies, etc. The setuptools package is required for installing Trac.
Check your setuptools version
The version of your setuptools installation can be checked with the following commands (should work for other Python packages too):
$ python Python 2.3.5 >>> import setuptools >>> setuptools.__version__ '0.7a1'
$ wget https://bootstrap.pypa.io/ez_setup.py -O - | python
- Do not use setuptools prior to version 0.6c10. If you are, look for the notes in an earlier version of this page.
- If you're using Python 2.4 (still supported for 0.12-stable) or Python 2.5, you won't be able to use a recent version of setuptools. You can still install an earlier version:
- grab and execute the older ez_setup.py script, you'll then have 0.6c11, which is enough if you're installing from a Trac checkout made with Subversion 1.6, but is problematic for newer Subversion versions.
- with easy_install from 0.6c11, install the latest Python 2.4/2.5 compatible version of the new setuptools:
easy_install -U setuptools==1.4.2
- Windows users will need to add the
Scriptsdirectory of their Python installation (for example,
C:\Python27\Scripts) to their
PATHenvironment variable, or use the full path to
C:\Python27\Scripts\easy_install.py). See Windows notes for more information.
- for Trac < 1.5.3, if you're using setuptools versions 5.4 through 5.6, the environment variable
PKG_RESOURCES_CACHE_ZIP_MANIFESTSshould be set, otherwise the performance of Trac will be significantly degraded.
$ export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
> set PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
Install Trac using
setuptools includes the
easy_install script for convenient installation of packages found on Python Package Index including Trac with all necessary dependencies.
$ python -m easy_install Trac
You will need root permissions or equivalent (e.g. sudo) for this step.
If you are working behind a proxy, note that easy_install will rely on environment variables, such as http_proxy, https_proxy, ftp_proxy.
Install Trac from source using
You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g.
Trac-1.0.tar.gz) from the TracDownload page, or you can get the source directly from the repository. See TracRepositories for details.
$ python ./setup.py install
This will byte-compile the Python source code and install it as an .egg file or folder in the
of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as
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):
$ python ./setup.py install
Alternatively, you can run
bdist_egg and copy the .egg from
dist/ to the place of your choice, or you can create a Windows installer (
To install Trac to a custom location, or find out about other advanced installation options, run:
$ easy_install --help
Also see Installing Python Modules for detailed information.
Specifically, you might be interested in:
$ easy_install --prefix=/path/to/installdir
or, if installing Trac on a Mac OS X system:
$ easy_install --prefix=/usr/local --install-dir=/Library/Python/2.7/site-packages
On Mac OSX, running
easy_install trac will install into
/Library/Python/2.7/site-packages by default.
trac-admin commands will be placed in
/usr/local/bin and will install the Trac libraries and dependencies into
/Library/Python/2.7/site-packages, which is Apple's preferred location for third-party Python application installations.
See also: TracDev/Proposals/Setuptools