Revision as of 15:45, 8 August 2011

Source Code via Git

This page is for developers and testers only. If you are just using OpenSim, but not involved in developing it, we ask that you stick to tagged releases, preferably binary distributions.

OpenSimulator uses Git as its source control tool. For more information on installing and using Git, please see Using Git.

Never, ever, ever, never run master git in production environments; it is not suitable for that unless you are very familiar with the source code, and can hot fix any piece of it (that probably means you are an OpenSim developer). Feedback and testing on the unstable tree is very much appreciated, as that helps us make the next release better.

• Latest git revision version (bleeding edge)

git clone git://opensimulator.org/git/opensim

• To checkout a specific revision

After creating the clone, change into the directory and:

git reset --hard ########

Where ######## is the unique hash of the version you are interested in.

• To clone the repository if you are a core developer

git clone ssh://<username>@opensimulator.org/var/git/opensim

Another option for obtaining the code is via subversion with our svn mirror. This mirrors all git changes since the old 10k1 changeset in subversion. It is synchronized every 15 minutes, so may be 15 minutes behind git master.

• Latest subversion revision version (bleeding edge)

svn co http://opensimulator.org/svn/opensim-track/trunk opensim

To do this with git:

git-svn clone http://opensimulator.org/svn/opensim-track opensim -T trunk

Release Code via Git

Instead of using a source archive release, you can pull specific releases from our git source code repository. For more information on installing and using Git, please see Using Git.

In each case you'll want to start with a clone:

git clone git://opensimulator.org/git/opensim

Then all other commands are run from inside the checked out directory. For example

• Command for retrieving 0.6.8

git checkout 0.6.8-release

• Command for retrieving 0.6.8 with ongoing fixes

git checkout -b 0.6.8-post-fixes origin/0.6.8-post-fixes

• Command for updating an existing checked out 0.6.8 branch with subsequent changes

git pull

Source Code via ViewGit Web Utility

You can also get OpenSimulator code via the ViewGit web utility at

http://opensimulator.org/viewgit/?a=summary&p=opensim

You'll see a list of revisions as shown below.

Scroll down, and you will see not just the master head, but also the several tagged releases and working branches.

The tarball or zip source code package for any particular revision can be downloaded by the tar/gz and zip links in the rightmost "Actions" column.