OpenSim.exe Command Line Options - Revision history

Tampa at 17:21, 11 September 2025

2025-09-11T17:21:10Z

Shy Robbiani: /* Switch Syntax */ Syntax as verified in Windows 8.1

2015-11-07T16:10:34Z

‎Switch Syntax: Syntax as verified in Windows 8.1

Justincc: /* Current Command Line Parameters */

2014-08-05T20:54:17Z

‎Current Command Line Parameters

Aiaustin: /* Current Switches */

2014-06-19T15:35:33Z

‎Current Switches

Aiaustin: /* Current Switches */ changed to show physics default in release is not BullertSim

2014-06-19T15:35:15Z

‎Current Switches: changed to show physics default in release is not BullertSim

Aiaustin: /* Current Switches */

2014-06-19T15:33:42Z

‎Current Switches

Aiaustin: /* For Simulator Operators */ changed switch to parameter to help avoid confusion. are some of these actually /switch style things like /D directory ?

2014-06-19T15:32:59Z

‎For Simulator Operators: changed switch to parameter to help avoid confusion. are some of these actually /switch style things like /D directory ?

Aiaustin: /* Switch Syntax */ has windows key value syntax changed? /console rest does not work

2014-06-19T15:22:47Z

‎Switch Syntax: has windows key value syntax changed? /console rest does not work

Justincc: Turns out that if you put - in front of the switches the table formatting gets confused! Don' thave time to work out how to escape these right now.

2014-05-28T19:14:32Z

Turns out that if you put - in front of the switches the table formatting gets confused! Don' thave time to work out how to escape these right now.

Justincc: /* Current Switches */

2014-05-28T19:13:12Z

‎Current Switches

← Older revision		Revision as of 17:21, 11 September 2025
Line 1:		Line 1:
−	{{Quicklinks}}	+	{{Quicklinks\|OpenSim.exe_Command_Line_Options}}

	Command line arguments, also known as switches, helpful to modify the behavior of your OpenSimulator for customized environments or debugging.		Command line arguments, also known as switches, helpful to modify the behavior of your OpenSimulator for customized environments or debugging.

@@ Line 7: / Line 7: @@
 === Switch Syntax ===
-* Windows: ''"/key:value" or "/key value" ''  (not valid any longer?  Check?, Windows seems to need -key value or -key=value)
+* Windows: ''"/key:value" or "/key value" '' as well as ''"-key=value" or "-key value" '' are valid (verified Windows 8.1)
 * Unix, Linux ''"-key=value" or "-key value" ''
 * MacOSX: FIXME

@@ Line 25: / Line 25: @@
 |logconfig
 |String(filepath)
-|OpenSimulator will configure log4net using this file as configuration file
+|OpenSimulator will use the specified .NET config file instead of the default.  This config file is mainly used to configure log4net, though it can also contain other parameters (so the -logconfig switch is somewhat misleading).
 |OpenSim.exe.config
 |-

@@ Line 17: / Line 17: @@
 It seems a bug in the regular syntax in the external Nini command line parser used by OpenSimulator.
-=== Current Switches ===
+=== Current Command Line Parameters ===
 The following command line parameters are known:

@@ Line 51: / Line 51: @@
 |"OpenDynamicsEngine", "BulletSim"
 |The name of the physics engine. It is the same as physics property in [Startup] section. See OpenSim.ini.example for the detailed information. It will override the settings in OpenSim.ini.
-|OpenDynamicsEngine in OpenSimulator 0.7.6.1 and before, BulletSim in current development code.
+|BulletSim in 0.8 onwards, OpenDynamicsEngine in OpenSimulator 0.7.6.1 and before.
 |-
 |gui

@@ Line 21: / Line 21: @@
 The following command line parameters are known:
 {|border="1" cellspacing="0"
-! Parameter !! Values !! Description !! Default
+! Key !! Values !! Description !! Default
 |-
 |logconfig

@@ Line 13: / Line 13: @@
 If you want to use a value which contains spaces, contain the entire values and spaces inside of double-quotes(").
-Note that "--" switches, like "--key=value" do not work.
+Note that "--" parameters, like "--key=value" do not work.
 It seems a bug in the regular syntax in the external Nini command line parser used by OpenSimulator.
@@ Line 19: / Line 19: @@
 === Current Switches ===
-The following command line switches are known:
+The following command line parameters are known:
 {|border="1" cellspacing="0"
-! Switch !! Values !! Description !! Default
+! Parameter !! Values !! Description !! Default
 |-
 |logconfig

@@ Line 19: / Line 19: @@
 === Current Switches ===
-The following command line switches are implemented:
+The following command line switches are known:
 {|border="1" cellspacing="0"
 ! Switch !! Values !! Description !! Default
 |-
-|-logconfig
+|logconfig
 |String(filepath)
 |OpenSimulator will configure log4net using this file as configuration file
 |OpenSim.exe.config
 |-
-|-background
+|background
 |Boolean
 |If true, OpenSimulator will run in the background
 |false
 |-
-|-inifile
+|inifile
 |String(filepath)
 |The path to the main ini config file.  If you change this then you must make sure that the necessary configuration content from OpenSim.ini is still being loaded (via includes, etc.).
 |OpenSim.ini
 |-
-|-inimaster
+|inimaster
 |String(filepath)
 |The path to the master ini file.  By default this points to OpenSimDefaults.ini which contains a large number of default settings for OpenSimulator.
 |OpenSimDefaults.ini
 |-
-|-inidirectory
+|inidirectory
 |String(filepath)
 |The path to folder for config ini files. OpenSimulator will read all of *.ini files in this directory and override OpenSim.ini settings.
 |config
 |-
-|-physics
+|physics
 |"OpenDynamicsEngine", "BulletSim"
 |The name of the physics engine. It is the same as physics property in [Startup] section. See OpenSim.ini.example for the detailed information. It will override the settings in OpenSim.ini.
 |OpenDynamicsEngine in OpenSimulator 0.7.6.1 and before, BulletSim in current development code.
 |-
-|-gui
+|gui
 |Boolean
 |"old-style" console ([http://opensimulator.org/mantis/view.php?id=4794 deprecated from Opensim 0.7], use -console=basic instead)
 |false
 |-
-|-console
+|console
 |"basic","rest"
 |If "basic", OpenSimulator will launch a simple console capable of processing commands. If "rest", a [[RestConsole]]. If others including empty, a console that uses cursor control and context help(default).
 |(empty)
 |-
-|-save_crashes
+|save_crashes
 |Boolean
 |If true, OpenSimulator will dump stacktraces into the file in the directory specified with 'crash_dir' when it crashes. Note: As of 0.7.1, it doesn't work. It works in 0.7.2-dev.
 |false
 |-
-|-crash_dir
+|crash_dir
 |String(filepath)
 |The path to the directory where crash logs will be created. When OpenSimulator crashes, it will be automatically created if not exists. Note: As of 0.7.1, it doesn't work. It works in 0.7.2-dev.