[[PageOutline(2-3)]] = Trac on Windows = == Install Python == Trac is written in [http://python.org Python], so you will first need to install it. The recommended version of Python at this time is 2.4.3. Many of Trac's dependencies are not available on Windows for Python 2.5, so that version is not yet recommended (but see [wiki:TracOnWindows/Python2.5 a workaround]). Download and run the Python MSI installer: [http://www.python.org/ftp/python/2.4.3/python-2.4.3.msi python-2.4.3.msi] == Experimental All-In-One Installer == This installation script only requires a Python 2.4 installation and will download and install the basic Trac dependencies and optionally the Subversion libraries. If you plan to use Subversion you'll first need to [#Subversion install their command-line tools]. 1. Download and double-click this script to install Trac: [attachment:trac-0.10.1-win32-install.py?format=raw trac-0.10.1-win32-install.py] 1. Download and run the installer for the Subversion command line tools: [http://subversion.tigris.org/files/documents/15/34093/svn-1.4.0-setup.exe svn-1.4.0-setup.exe] 1. Once that's done you can skip ahead to [#GettingStarted Getting Started]. == Manual Installation == If you don't use the ''All-In-One Installer'', you'll have to download and install a few packages manually. === Setuptools === [http://peak.telecommunity.com/DevCenter/setuptools Setuptools] makes installation of Python software easier by automatically downloading and installing Python packages from the internet. It is also used to find and load [wiki:TracPlugins Trac's plugins]. Download the setuptools installer: [http://peak.telecommunity.com/dist/ez_setup.py ez_setup.py] When the download completes double-click the "ez_setup.py" file from your download folder to install setuptools. === The command line === You'll need to open a command line to install some of the necessary software: 1. Click "Start" > "Run..." (or press Win+R) 1. Type "cmd" and click "Ok" 1. Type "cd \Python24\Scripts" You should now be in the folder "C:\Python24\Scripts" where you can run the "easy_install" command to install the required software. Install the [http://www.clearsilver.net/ ClearSilver] template language: {{{ easy_install -f http://clearsilver.net/downloads clearsilver==0.9.14 }}} Install the [http://pysqlite.org PySqlite] database driver: {{{ easy_install pysqlite }}} ''TODO: setting up for PostgreSQL or MySQL'' === Subversion (optional) === #Subversion ==== ==== #svntools Trac can integrate with the [http://subversion.tigris.org Subversion] version control software. Follow these steps if you'd like to use Trac with Subversion. You can learn more about how they can integrate from the wiki: TracSubversion. This document covers using the Subversion command line tools, but you can also use the [http://tortoisesvn.net/ TortoiseSVN] Windows GUI. Download and run the installer for the Subversion command line tools: [http://subversion.tigris.org/files/documents/15/34093/svn-1.4.0-setup.exe svn-1.4.0-setup.exe] ==== ==== #svnbindings Go back to your command line to install the Subversion Python library: {{{ easy_install -Z http://subversion.tigris.org/downloads/svn-python-1.4.0-py2.4.exe }}} '''Note:''' the "-Z" option is necessary when installing Subversion so that it is "unzipped". Trac will not be able to access Subversion if it is zipped. === Download Trac === Download and run the Trac Windows installer: [http://ftp.edgewall.com/pub/trac/trac-0.10.win32.exe trac-0.10.win32.exe] '''Note:''' do '''not''' run easy_install on the Trac installer. This is not currently supported and Trac will not work correctly when installed this way. == Getting Started == Ok, now that Trac and all its requirements have been installed you can create your first project and try it out. This example will create the projects in "C:\Projects". This is a good default location, but you can put them in another drive or folder if you prefer. Back to the command line: {{{ cd \ mkdir Projects cd Projects }}} '''Optional:''' if you're using Trac with Subversion you can create a new repository for your source code: {{{ mkdir svn svnadmin create svn\my-project }}} Initialize a new Trac project environment: {{{ mkdir trac \Python24\python.exe \Python24\Scripts\trac-admin trac\my-project initenv }}} Follow the interactive prompts to input information about your project. If you are unsure what to put you can simply press "Enter" to accept the default value. '''Subversion users:''' when asked for the "Path to repository" input the folder of the repository you just created: {{{ Path to repository [/path/to/repos]> c:/Projects/svn/my-project }}} == Try it out == Trac includes a standalone webserver called [wiki:TracStandalone tracd]. You can also use Trac with other webservers, but you should first try tracd to make sure everything's set up and working correctly: You should still be in the "C:\Projects" folder on the command line: {{{ \Python24\python.exe \Python24\Scripts\tracd -p8000 trac\my-project }}} Open your browser to http://localhost:8000 to test out your new Trac project. Press Ctrl+Break to stop tracd == Troubleshooting == ==== Unsupported version control system "svn" ==== The Subversion library is not installed properly. Be sure you used the "-Z" option with easy_install when [#svnbindings installing] the Subversion bindings. == What's next? == ''TODO: intro to advanced setup options'' == Comments == * Hopefully this 0.10 rewrite can include upgrade instructions for 0.9.6 users. That would be immensely comforting. Thanks for your excellent work... * I'm sorry but I'm having fits with this installation. For example, the given All-In-One Installer seems to install dependencies - and not the SVN application. The link provided for "install their command-line tools." simply jumps to the Optional Subversion install. So which goes in first - SVN or the installer? Just a bit frustrated being new to this and being a Pointy Haired Boss who doesn't have the mental bandwidth nor team time to focus in for 2 hrs to go through all of this. Windows XP SP2. - If you're a real PHB, how come you don't have the 2 days to set up a meeting and afterwards ask your local Dilbert to run a 2 weeks evaluation period ;) Sorry, couldn't resist... More to the point, you should install the Subversion tools and more importantly the bindings first.