Download

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Test package)
 
(264 intermediate revisions by 29 users not shown)
Line 1: Line 1:
{{Template:Quicklinks}}
+
{{Quicklinks}}{{ReleaseInfo}}
=Source code=
+
= Introduction =
Here are the current released versions of OpenSim.
+
<font color="#ff0000">'''Note 1:'''</font> If you are reading this on any site but http://www.opensimulator.org, you might not be actually downloading OpenSimulator.org software. Please check your browser URL before proceeding any further.
  
Please see [[Branches]] for more information on the repository branches and what they are for.
+
<font color="#ff0000">'''Note 2:'''</font> Depending on what you want to do with OpenSimulator, setting it up and keeping it running will require a fair amount of technical knowledge. After downloading OpenSim, please consult the several instruction manuals on this Wiki and elsewhere. Please be aware that the learning curve for operating OpenSimulator is steep.
  
<font color=red>'''Please note:'''</font> As OpenSim is still at an alpha code maturity stage, there is absolutely no guarantee that functionality works or is stable, even in the numbered releases.  Certain features may not work either because the code is in rapid evolution, or because functionality expected by the Linden Labs Second Life viewer has simply not been implemented yet.  However, constructive feedback is still welcomed.
+
<font color="#ff0000">'''Note 3:'''</font> Many Linux distros (including Ubuntu) ship with only the "mono-runtime" package installed, however you need to install "mono-complete" for some OpenSimulator features such as LSL script commands.
  
Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.
+
<font color="#ff0000">'''Note 4:'''</font> OpenSimulator is made available under the [[BSD License]].  Downloaders of the code also receive an additional [[IP Rights Grant]] for any intellectual property licensed to OpenSimulator under the terms of the [[Contributions_Policy#OpenSimulator_Licensing_Conditions|Contribution Agreements]].
  
The latest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.6''' and provided as:
+
Windows users may need to unblock the downloaded archives, or windows my refuse to execute the programs.
* http://dist.opensimulator.org/opensim-0.6.6-release.tar.gz - best for Linux systems
+
Right click the archive file, see Properties, and mark Unblock at end if present.
* http://dist.opensimulator.org/opensim-0.6.6-release.zip - best for Windows systems
+
  
The only difference between the two is the archive format, the source is exactly the same.
+
= Binary Packages =
  
== Release Code via Git ==
+
== Current release ==
 +
Once you've unzipped/untarred these you'll be able to run OpenSimulator 'out of the box' in simple standalone mode - no code compilation or other installation required.
  
Instead of using a source archive release, you can pull specific releases from our git repository.  For more information on installing and using Git, please see [[Using_Git]].
+
The current release is '''{{#var:currentversion}}''' (released on {{#var:releasedate}}) and can be downloaded as
  
In each case you'll want to start with a clone:
+
*[{{#var:url_bingz}} opensim-{{#var:currentversion}}.tar.gz]
 +
or
 +
*[{{#var:url_binzip}} opensim-{{#var:currentversion}}.zip]
  
git clone git://opensimulator.org/git/opensim opensim-0.6.6
+
After unpacking please read the [[{{#var:currentversion}} Release]] Notes.
 +
Further instructions on running OpenSimulator may be found in README.txt after you untar/unzip the archives and within this wiki.
  
Then all other commands are run from inside the checked out directory.
+
== Test package ==
 +
at [https://github.com/opensim/opensim/releases our github releases] you may find recent test packages named
 +
* LastDotNetAutoBuild built for dotnet 6.0
  
* '''0.6.6 Alpha with post-release fixes''' (preferred)
 
git checkout 0.6.6-post-fixes
 
  
* '''0.6.6 Alpha release tag'''
+
Note that this is code in current development. It can occasionally be bad, so use with care.<br>
git checkout 0.6.6-release
+
Backup your regions, (grid,) and databases before any update, in particular to this test code.<br>
 +
Use the provided ini files examples to create your own. Do not use older ones<br>
 +
It is compiled in Release mode, as future OpenSim releases will be. This may make debug a bit harder.<br>
 +
Source code can be found at [[Developer_Documentation#Source_Code_Repository_Access|OpenSimulator source code repository]]
 +
<!--
 +
== Release candidate ==
 +
Binary packages of the current candidate for the next OpenSimulator release are provided in .zip or .tar.gz form.  This candidate is made available for testing - if you require more tested code then please download the current release instead.  The two packages are theoretically identical, though the .tar.gz was built on mono while the .zip was built under .NET.
  
== Release notes ==
+
* [{{#var:url_testbingz}} opensim-{{#var:currenttestversion}}.tar.gz]
 +
* [{{#var:url_testbinzip}} opensim-{{#var:currenttestversion}}.zip]
  
These are extracted from the subversion history log and correlated with the tagged releases.  It should provide some idea of the changes between each tagged version.  How ever, since the tagged releases are moved out of the trunk, the versions aren't an exact correlation.  Please read and understand [[Release Cycle]] and [[On revisions, tags and branches]] before using this information.
+
Temporary release notes: [[0.9.0.0 Release]]
* [[Recent]] (since last tagged version)
+
* [[0.6.6-release]] (SVN version 9961)
+
* [[0.6.5-release]] (SVN version 9667)
+
* [[0.6.4.1-release]] (SVN version 9009)
+
* [[0.6.4-release]] (SVN version 8960)
+
* [[0.6.3-release]] (SVN version 8506)
+
* [[0.6.2-release]] (SVN version 8068)
+
* [[0.6.1-release]] (SVN version 7880)
+
* [[0.6.0-release]] (SVN version 7176)
+
* [[0.5.11-release]] (SVN version 6676)
+
* [[0.5.10-release]] (SVN version 6422)
+
* [[0.5.9-release]] (SVN version 5970)
+
* [[0.5.8-release]] (SVN version 5111)
+
* [[0.5.7-release]] (SVN version 4818)
+
* [[0.5.6-release]] (SVN version 4488)
+
* [[0.5.5-release]] (SVN version 4239)
+
* [[0.5.4-release]] (SVN version 3879) (Not sure what happened to 0.5.3 & 0.5.2)
+
* [[0.5.1-release]] (SVN version 3724)
+
* [[0.5.0-release]] (SVN version 3184)
+
* [[0.4.5.3-stable]] (SVN version 2844)
+
* [[0.4.5.2-stable]] (SVN version 2772)
+
* [[0.4.5.1-stable]] (SVN version 2610)
+
* [[0.4.5-release]] (SVN version 2293)
+
* [[0.4.0-rc]] (SVN version 1953)
+
* [[0.3.2-release]] (SVN version 1385)
+
* [[0.3.1-devel]] (SVN version 1226) (Around here things start to get a bit confusing)
+
* [[0.2.1-release]] (SVN version 1224)
+
* [[0.3.0-devel]] (SVN version 1126)
+
* [[0.0.0-release]] (SVN version 1022)
+
* [[0.1.0-release]] (SVN version 1021)
+
* [[0.2.0-release]] (SVN version 1020)
+
  
=Binaries=
+
Further instructions may be found in README.txt after you untar/unzip the archives.
The OpenSim project only does source based releases, which you must [[Build_Instructions|compile]] yourself. Many members of our community provide binary installers that you can used based on those source releases.  Links below are provided for convenience.
+
-->
  
==Installers==
+
= Other Distributions =
  
* '''0.6.6 Windows Installer (Post-fixes version r9993)'''
+
OpenSimulator is a BSD licensed codebase, so other projects are welcome to repackage OpenSimulator and add their own modules or configurationCurrent known public distributions are
  http://forge.opensimulator.org/gf/download/frsrelease/199/588/OpenSim0.6.6Setup.exe
+
  
* '''0.6.6 Mac OS X Installer (Post-fixes version r9993)'''
+
* Diva Distribution, a '''Preconfigured hypergrided standalone,''' binary distribution. Easy to setup and to keep up to date. Windows and Linux/Unix. Download the file diva-rNNNN.zip, unzip it, read README.txt and take it from there. <br />http://metaverseink.com/Downloads.html
http://forge.opensimulator.org/gf/download/frsrelease/198/587/OpenSimulator-0.6.6-post-fixes-r9993.dmg
+
  
* '''[[UnofficialDebPackages|Unofficial .deb packages]]
+
* OSGrid distribution. This is preconfigured for connection of an OpenSimulator instance to OSGrid. <br />https://www.osgrid.org/download.php
  
= Older Versions Archive =
+
* DreamGrid is a free, pre-packaged Windows-compatible virtual reality OpenSimulator system that is easy to install, easy to run, and powerful.<br />https://www.outworldz.com/Outworldz_installer/Grid/
  
All older versions of OpenSim are available from the Git repo (this includes fully converted versions of every change that existed in the subversion repository, including all old tags and branches). Please be aware that even if there is zero official support for the latest version, there's even less support for older ones. They are kept here for historical and technological reference only.
+
= Source code =
  
The 'official' release tags and branches are all available from:
+
== Current release ==
git://opensimulator.org/git/opensim
+
The two packages are identical apart from their compression formats.
  
The named branches are typically extremely experimental offshoots. Stick with recent numbered versions if you expect anything to work.
+
*[{{#var:url_srcgz}} opensim-{{#var:currentversion}}-source.tar.gz] or
 +
*[{{#var:url_srczip}} opensim-{{#var:currentversion}}-source.zip]
  
= Experimental Upstream Code =
+
== Source code repository ==
<font style="color: red; font-size: big">'''There Be Dragons Beyond This Point'''</font>
+
You can also download code directly from the [[Developer_Documentation#Source_Code_Repository_Access|OpenSimulator source code repository]].  However, we only suggest doing this if you've very familiar with OpenSimulator.  Master development code at any point may be broken or may contain database changes that later need to be reversed.
  
If you are truly feeling dangerous, adventurous, or want to help us test the next version of OpenSim you are welcome to grab the latest unstable code out of our git master repository.  Any warnings previous expressed about the alpha nature of the code go double or triple if you are running directly off of master. '''Never, ever, ever, never''' run this 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 core member).  Feedback and testing on the unstable tree is appreciated, as that helps us make the next release better.  If this scares you from using trunk, that was intended.
+
= Previous releases =
 +
You can find previous releases of OpenSimulator at http://opensimulator.org/dist. Some old releases only have source code packages.
  
If it breaks, you get to keep both pieces.
+
Previous [[Release Notes]]
  
* '''Latest git revision version (bleeding edge)'''
+
= Developers and Testers =
git clone git://opensimulator.org/git/opensim
+
If you're a developer or a tester and you want to download possibly broken development code then please [[Developer Documentation#Source Code Repository Access|go here]]
  
* '''To checkout a specific revision'''
+
= Related Software =
After creating the clone, chnage into the directory and:
+
* [[Related Software|Related Software Section]] - Here you can find details on OpenSimulator compatible viewers, external components (e.g. web sign-up systems) and add-on region modules.
git reset --hard ########
+
 
+
Where ######## is the unique hash of the version you are interested in.
+
 
+
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
+
 
+
=Related Software=
+
[[Related_Software|Related Software Section - CLICK HERE]]<br><br>
+
  
 +
<!--
 
''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]<br />
 
''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]<br />
  
 
[[Category:Users]]
 
[[Category:Users]]
 
[[Category:Developers]]
 
[[Category:Developers]]
<cleanpage title=hide cats=hide />
+
[[Category:Scripts]]
 +
-->

Latest revision as of 08:42, 27 November 2023

Contents

[edit] Introduction

Note 1: If you are reading this on any site but http://www.opensimulator.org, you might not be actually downloading OpenSimulator.org software. Please check your browser URL before proceeding any further.

Note 2: Depending on what you want to do with OpenSimulator, setting it up and keeping it running will require a fair amount of technical knowledge. After downloading OpenSim, please consult the several instruction manuals on this Wiki and elsewhere. Please be aware that the learning curve for operating OpenSimulator is steep.

Note 3: Many Linux distros (including Ubuntu) ship with only the "mono-runtime" package installed, however you need to install "mono-complete" for some OpenSimulator features such as LSL script commands.

Note 4: OpenSimulator is made available under the BSD License. Downloaders of the code also receive an additional IP Rights Grant for any intellectual property licensed to OpenSimulator under the terms of the Contribution Agreements.

Windows users may need to unblock the downloaded archives, or windows my refuse to execute the programs. Right click the archive file, see Properties, and mark Unblock at end if present.

[edit] Binary Packages

[edit] Current release

Once you've unzipped/untarred these you'll be able to run OpenSimulator 'out of the box' in simple standalone mode - no code compilation or other installation required.

The current release is 0.9.2.2 (released on March 29, 2023) and can be downloaded as

or

After unpacking please read the 0.9.2.2 Release Notes. Further instructions on running OpenSimulator may be found in README.txt after you untar/unzip the archives and within this wiki.

[edit] Test package

at our github releases you may find recent test packages named

  • LastDotNetAutoBuild built for dotnet 6.0


Note that this is code in current development. It can occasionally be bad, so use with care.
Backup your regions, (grid,) and databases before any update, in particular to this test code.
Use the provided ini files examples to create your own. Do not use older ones
It is compiled in Release mode, as future OpenSim releases will be. This may make debug a bit harder.
Source code can be found at OpenSimulator source code repository

[edit] Other Distributions

OpenSimulator is a BSD licensed codebase, so other projects are welcome to repackage OpenSimulator and add their own modules or configuration. Current known public distributions are

  • Diva Distribution, a Preconfigured hypergrided standalone, binary distribution. Easy to setup and to keep up to date. Windows and Linux/Unix. Download the file diva-rNNNN.zip, unzip it, read README.txt and take it from there.
    http://metaverseink.com/Downloads.html

[edit] Source code

[edit] Current release

The two packages are identical apart from their compression formats.

[edit] Source code repository

You can also download code directly from the OpenSimulator source code repository. However, we only suggest doing this if you've very familiar with OpenSimulator. Master development code at any point may be broken or may contain database changes that later need to be reversed.

[edit] Previous releases

You can find previous releases of OpenSimulator at http://opensimulator.org/dist. Some old releases only have source code packages.

Previous Release Notes

[edit] Developers and Testers

If you're a developer or a tester and you want to download possibly broken development code then please go here

[edit] Related Software

  • Related Software Section - Here you can find details on OpenSimulator compatible viewers, external components (e.g. web sign-up systems) and add-on region modules.


Personal tools
General
About This Wiki