{{Quicklinks}}
 
{{Quicklinks}}
    +
= Note =
 +
 +
These instructions assume that OpenSimulator is running from the binary packages in standalone mode.  If this is not the case or you have more complex requirements (e.g. you want to use the MySQL database rather than SQLite or you want to run in grid mode), then you will need to [[Configuration|configure]] OpenSimulator first.
 +
 +
= Dependencies =
 
In addition to the OpenSimulator code itself, certain other packages need to be installed on different platforms in order to get OpenSimulator binaries to run.  
 
In addition to the OpenSimulator code itself, certain other packages need to be installed on different platforms in order to get OpenSimulator binaries to run.  
    
[[NAT Loopback Routers]] Router and Nat Loopback Information to help you configure your Router / Modem.
 
[[NAT Loopback Routers]] Router and Nat Loopback Information to help you configure your Router / Modem.
    +
== Windows ==
   −
 
+
The current OpenSimulator release and development code requires .NET Framework 4.0.
= Windows =
+
 
+
OpenSimulator now requires '''.NET Framework 3.5''' when running under Windows.  If you run OpenSimulator on '''Windows 7''' or '''Windows Server 2008 R2''', it is already bundled so you can run OpenSimulator 0.7.1 out-of-the-box. On '''Windows Vista''', '''Windows Server 2008''', '''Windows Server 2003''' or '''Windows XP''', you'll need to upgrade it to 3.5(or later, but NET Framework 4.0 not officially supported by OpenSimulator yet), downloading from [http://msdn.microsoft.com/en-us/netframework/cc378097 Microsoft .NET Framework Download Page@.NET Framework Developer Center]. Note that prior versions of Windows(ex. NT or 2000) are NOT supported.
+
 
+
If you run on Windows XP ensure it is updated to at least Service Pack 2 (SP2).  
+
    
Double-click or execute on command prompt:
 
Double-click or execute on command prompt:
*32-bit version of Windows: '''OpenSim.exe'''
+
*'''OpenSim.exe'''
*64-bit version of Windows: '''OpenSim.32BitLaunch.exe'''
+
 
 
Depending on your installation, you may have to run the program as administrator(right click -> 'Run as administrator'). It will pop up a window asking permission, select "Allow".
 
Depending on your installation, you may have to run the program as administrator(right click -> 'Run as administrator'). It will pop up a window asking permission, select "Allow".
    +
== Linux and Mac OSX ==
   −
= Linux and Mac OSX =
+
{| class="wikitable"
 +
|-
 +
! scope="col"| Mono version
 +
! scope="col"| OpenSimulator version
 +
! scope="col"| Status
 +
! scope="col"| Notes
 +
|-
 +
! scope="row"| 2.4.3+
 +
| 0.7.6
 +
| Ok
 +
|
 +
|-
 +
! scope="row"| 2.6.x
 +
| < 0.7.6
 +
| Ok
 +
| Appears to be fine, though the mono VM does seem to have some issues (crashing with a native stacktrace) on simulators running many regions or lots of users/prims
 +
|-
 +
! scope="row"| 2.8.x
 +
| *
 +
| Not ok
 +
| Significant performance and scalability problems
 +
|-
 +
! scope="row"| 2.10.0
 +
| *
 +
| Not ok
 +
| Significant performance and scalability problems
 +
|-
 +
! scope="row"| 2.10.1
 +
| *
 +
| Not ok
 +
| Significant performance and scalability problems
 +
|-
 +
! scope="row"| 2.10.2
 +
| *
 +
| Ok
 +
|
 +
|-
 +
! scope="row"| 2.10.8
 +
| < 0.9
 +
| Ok (recommended)
 +
|
 +
|-
 +
! scope="row"| 2.10.9 > 3.0.3
 +
| *
 +
| Not ok
 +
| Major issues
 +
|-
 +
! scope="row"| 3.0.7
 +
| *
 +
| Ok
 +
|
 +
|-
 +
! scope="row"| 4.0
 +
| *
 +
| Not Ok
 +
|
 +
|-
 +
! scope="row"| 4.0.4
 +
| *
 +
| Ok
 +
|
 +
|-
 +
! scope="row"| 4.3.2
 +
| *
 +
| Ok
 +
|
 +
|-
 +
! scope="row"| 4.4.2
 +
| *
 +
| Not Ok
 +
| Some issues on Robust like NameResolutionFailure
 +
|-
 +
! scope="row"| 4.6.2.16
 +
| *
 +
| Not Ok
 +
|
 +
|-
 +
! scope="row"| 5.x
 +
| *
 +
| seems to work
 +
| but : http://opensimulator.org/mantis/view.php?id=8251
 +
|-
 +
|}
   −
OpenSimulator requires Mono 2.4.3 or later. '''WARNING:''' OpenSimulator is known to have significant performance and scalability problems with Mono versions 2.8.x, 2.10.0 and 2.10.1. As of Mono 2.10.2, the scalability problems appear to have been resolved. Mono 2.6.x also appears to be fine, though the mono VM does seem to have some issues (crashing with a native stacktrace) on simulators running many regions or lots of users/prims.  Therefore you should either use Mono 2.6.x or Mono 2.10.2 or later. You can also use Mono 2.4.3, but it is fairly old now.
+
 
 +
OpenSimulator development code requires Mono 2.8 or later, with at least Mono 2.10.8 recommended.
    
To run OpenSimulator with mono, execute  
 
To run OpenSimulator with mono, execute  
 
This is the same for 32 bit and 64 bit systems.  The --debug switch isn't strictly necessary, but it will insert line numbers for stack traces if you ever need to make a bug report, and the overhead of using it is very small.
 
This is the same for 32 bit and 64 bit systems.  The --debug switch isn't strictly necessary, but it will insert line numbers for stack traces if you ever need to make a bug report, and the overhead of using it is very small.
   −
== Ubuntu ==
+
=== Ubuntu ===
    
  sudo apt-get install mono-complete
 
  sudo apt-get install mono-complete
    
{{anchor|CentOS}}{{anchor|RedHat}}{{anchor|RHEL}}{{anchor|Fedora}}
 
{{anchor|CentOS}}{{anchor|RedHat}}{{anchor|RHEL}}{{anchor|Fedora}}