Galaxy Download and Installation

(Watch or Stream Screencast)


(Note: You only need to download Galaxy if you plan to (1) develop it further (ImplementationInfo), (2) add new tools (AddToolTutorial), or (3) plug-in new datasources (DataSources).)

The installation procedure is simple and is nearly identical for UNIX and Mac computers. We are no longer supporting the Windows platform with our distribution, so you will have to build your own Python eggs if you want to install it on Windows (see GalaxyInWindows for some tips). Of course, Windows users can use our central Galaxy server from their browsers.

Mac OS X 10.3+ users are encouraged to install MacPython, as Galaxy is tested with this specific build of Python. For 10.5, you should be able to use the system-provided Python, but we have not yet tested and confirmed this.


1. Get the latest copy from the repository:

The latest source code can be downloaded from the anonymous Mercurial repository with this command:

hg clone http://www.bx.psu.edu/hg/galaxy galaxy_dist

If you don't have Mercurial, tarballs can be downloaded instead: bzipped or gzipped.

A mirror of the Mercurial repository is also available in Subversion:

svn co http://www.bx.psu.edu/svn/galaxy galaxy_dist



2. Enable configuration files and download eggs:

Once the source code is downloaded, cd to the galaxy_dist directory and run the setup.sh script. This will copy sample configuration files and download the proper eggs for your platform:

cd galaxy_dist
sh setup.sh



3. Start it up:

At this point GALAXY is ready to run. Simply type the following command:

sh run.sh

This will start up the server on localhost and port 8080, so type http://localhost:8080 in your web browser.

Here GALAXY is run locally showing that developers do not need any special environment for running and developing its code. To make GALAXY available to other users on the network simply modify the universe_wsgi.ini file to specify the IP address of the machine GALAXY is installed on and restart the instance. No other configuration is necessary. If GALAXY needs to be run in a distributed computing environment the same universe_wsgi.ini file contains options for taking advantage of the PBS and Sun Grid Engine queue management systems (for more information, see ClusteringGalaxy).

Please note that some tools do have outside dependencies that cannot be provided with Galaxy for various reasons. The list of these dependencies can be found on the ToolDependencies page.



Advanced Configuration