Browse INI sections
Dedicated section search, alphabetical index and detailed settings from the catalog.
[Network] (29 settings)
Simulator network settings: addresses, ports and communication.
29 settings
AllowllHTTPRequestIn bool
Catalog value : false
Technical description (original English : By default, scripts are not allowed to call private services via llHttpRequest() Such calls are detected by the X-SecondLife-Shared HTTP header If you allow such calls you must be sure that they are restricted to very trusted scripters (remember scripts can also be in visiting avatar attachments). This can be overriden in individual private service sections if necessary
Source code : OpenSim/Framework/ServiceAuth/ServiceAuth.cs:45
Referenced files:
bin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
AuthType string
Catalog value : code: None / ini: BasicHttpAuthentication, None
Technical description (original English : The following 3 variables are for HTTP Basic Authentication for the Robust services. Use this if your central services in port 8003 need to be accessible on the Internet but you want to protect them from unauthorized access. The username and password here need to match the ones in the Robust service configuration. [Also looked up in: Groups, Messaging (later sections override earlier).]
Source code : OpenSim/Addons/Groups/Remote/GroupsServiceRemoteConnector.cs:64 | OpenSim/Addons/OfflineIM/Remote/OfflineIMServiceRemoteConnector.cs:71 | OpenSim/Framework/ServiceAuth/ServiceAuth.cs:50 | OpenSim/Services/Connectors/BaseServiceConnector.cs:22
Referenced files:
bin/OpenSim.ini.example— Template / example / testbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
cert_pass string
Catalog value : ***
Technical description (original English : Password for cert
Source code : OpenSim/Framework/NetworkServersInfo.cs:77 | OpenSim/Server/Base/HttpServerBase.cs:101 | OpenSim/Server/Base/HttpServerBase.cs:128
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
cert_path string
Catalog value : code: "" / ini: path/to/cert.p12
Technical description (original English : Path to X509 certificate, can be the same as main or another
Source code : OpenSim/Framework/NetworkServersInfo.cs:76 | OpenSim/Server/Base/HttpServerBase.cs:94 | OpenSim/Server/Base/HttpServerBase.cs:122
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
console_port int
Catalog value : 0
Technical description (original English : Port for console connections. Default: 0.
Source code : OpenSim/Region/Application/OpenSim.cs:110
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
ConsoleAllowedOrigin string
Catalog value : ""
Technical description (original English : From code: Woefully underdocumented, this is what makes javascript console clients work. Set to "*" for anywhere or (better) to specific addresses.
Source code : OpenSim/Framework/Console/RemoteConsole.cs:175
Referenced files:
bin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
ConsolePass string
Catalog value : ***
Technical description (original English : Password for console account.
Source code : OpenSim/Framework/Console/RemoteConsole.cs:170 | addon-modules/21Wifi/WebApp/WebApp.cs:412
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
ConsolePort int
Catalog value : 0
Technical description (original English : * The following are for the remote console * They have no effect for the local or basic console types * Leave commented to disable logins to the console
Source code : OpenSim/Server/Base/HttpServerBase.cs:75
Referenced files:
bin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
ConsoleUser string
Catalog value : code: "" / ini: Test
Technical description (original English : User name for console account. Configure the remote console user here. This will not actually be used unless you use -console=rest at startup.
Source code : OpenSim/Framework/Console/RemoteConsole.cs:169 | addon-modules/21Wifi/WebApp/WebApp.cs:411
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
ExternalHostNameForLSL string
Catalog value : code: null / ini: 127.0.0.1, ${Const|BaseHostname}
Technical description (original English : Hostname to use in llRequestURL/llRequestSecureURL must be a valid hostname for the ssl cert. if not defined - llRequestURL/llRequestSecureURL are disabled
Source code : OpenSim/Region/CoreModules/Scripting/LSLHttp/UrlModule.cs:134
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
http_listener_cert_pass string
Catalog value : ***
Technical description (original English : if the cert doesnt have a oficial CA or is selfsigned viewers option NoVerifySSLCert need to be set true
Source code : OpenSim/Framework/NetworkServersInfo.cs:69
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
http_listener_cert_path string
Catalog value : code: "" / ini: mycert.p12, SSL\ssl\OpenSim.p12
Technical description (original English : if the cert doesnt have a oficial CA or is selfsigned viewers option NoVerifySSLCert need to be set true
Source code : OpenSim/Framework/NetworkServersInfo.cs:68
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
http_listener_cn string
Catalog value : code: localhost / ini: myRegionsExternalHostName
Technical description (original English : currently if using ssl, regions ExternalHostName must the the same and equal to http_listener_cn this will change is future
Source code : OpenSim/Framework/NetworkServersInfo.cs:67
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
http_listener_port int | string
Catalog value : 9000
Technical description (original English : TCP Port for this simulator to listen on? (This must be unique to the simulator!). Default: 9000. Simulator HTTP port. This is not the region port, but the port the entire simulator listens on. This port uses the TCP protocol, while the region ports use UDP.
Source code : OpenSim/Framework/NetworkServersInfo.cs:64 | OpenSim/Region/CoreModules/Scripting/LSLHttp/UrlModule.cs:138 | OpenSim/Region/OptionalModules/DataSnapshot/DataSnapshotManager.cs:142 | OpenSim/Server/Handlers/Grid/GridInfoHandlers.cs:137
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
http_listener_ssl bool
Catalog value : false
Technical description (original English : ssl config: Experimental!
Source code : OpenSim/Framework/NetworkServersInfo.cs:66
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
http_listener_sslport int
Catalog value : ini: 9001 (code: (int)ConfigSettings.DefaultRegionHttpPort + 1)
Technical description (original English : ssl config: Experimental!
Source code : OpenSim/Framework/NetworkServersInfo.cs:65
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
HttpAuthPassword string
Catalog value : ***
Technical description (original English : The following 3 variables are for HTTP Basic Authentication for the Robust services. Use this if your central services in port 8003 need to be accessible on the Internet but you want to protect them from unauthorized access. The username and password here need to match the ones in the Robust service configuration.
Source code : OpenSim/Framework/ServiceAuth/BasicHttpAuthentication.cs:59
Referenced files:
bin/OpenSim.ini.example— Template / example / testbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
HttpAuthUsername string
Catalog value : code: "" / ini: some_username
Technical description (original English : The following 3 variables are for HTTP Basic Authentication for the Robust services. Use this if your central services in port 8003 need to be accessible on the Internet but you want to protect them from unauthorized access. The username and password here need to match the ones in the Robust service configuration.
Source code : OpenSim/Framework/ServiceAuth/BasicHttpAuthentication.cs:58
Referenced files:
bin/OpenSim.ini.example— Template / example / testbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
HttpBodyMaxLenMAX int
Catalog value : 16384
Technical description (original English : Maximum bytes allowed for HTTP_BODY_MAXLENGTH. By default, llHTTPRequest limits the response body to 2048 bytes. This limit can be extended using HTTP_BODY_MAXLENGTH to a maximum of HttpBodyMaxLenMAX bytes.
Source code : OpenSim/Region/CoreModules/Scripting/HttpRequest/ScriptsHttpRequests.cs:124
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
https_listener bool
Catalog value : false
Technical description (original English : addicional HTTPS for "Out of band" management applications such as the remote admin module or scripts Create https_listener = "True" will create a listener on the port specified. Provide the path to your server certificate along with it's password
Source code : OpenSim/Framework/NetworkServersInfo.cs:72 | OpenSim/Region/CoreModules/Scripting/LSLHttp/UrlModule.cs:136 | OpenSim/Server/Base/HttpServerBase.cs:72
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
https_main bool
Catalog value : false
Technical description (original English : HTTPS for "Out of band" management applications such as the remote admin module. May specify https_main = True to make the main http server use https or "False" to make the main server HTTP
Source code : OpenSim/Server/Base/HttpServerBase.cs:71
Referenced files:
bin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
https_port int
Catalog value : 0
Technical description (original English : Set our listener to this port
Source code : OpenSim/Framework/NetworkServersInfo.cs:78 | OpenSim/Region/CoreModules/Scripting/LSLHttp/UrlModule.cs:141 | OpenSim/Server/Base/HttpServerBase.cs:117
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
MaxRequestConcurrency
Catalog value : 30
Technical description (original English : OpenSim can send multiple simultaneous requests for services such as asset retrieval. However, some versions of mono appear to hang when there are too many simultaneous requests, default is 30 and is currently applied only to assets [Appears only in INI files; no literal read found in C# (may be read via a dynamic key, by another program, or obsolete).]
Source code :
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaults
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
OutboundDisallowForUserScripts string
Catalog value : 0.0.0.0/8|10.0.0.0/8|100.64.0.0/10|127.0.0.0/8|169.254.0.0/16|172.16.0.0/12|192.0.0.0/24|192.0.2.0/24|192.88.99.0/24|192.168.0.0/16|198.18.0.0/15|198.51.100.0/24|203.0.113.0/24|224.0.0.0/4|240.0.0.0/4|255.255.255.255/32
Technical description (original English : Disallow the following address ranges for user scripting calls (e.g. llHttpRequest()) This is based on http://en.wikipedia.org/wiki/Reserved_IP_addresses This stops users making HTTP calls to machines in the simulator's local network. If you need to allow some LAN calls we recommend you use OutboundDisallowForUserScriptsExcept documented in OpenSim.ini.example If you override OutboundDisallowForUserScripts directly you need to be very careful. Network ranges are specified in CIDR notation (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation) with multiple entries separated by | To specify an individual IP address use the /32 netmask (e.g. 192.168.1.3/32) You can also specify individual <addr>:<port> endpoints (e.g. 192.168.1.3:8003) If an address if given without a port number then port 80 is assumed.
Source code : OpenSim/Framework/OutboundUrlFilter.cs:83
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaults
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
OutboundDisallowForUserScriptsExcept string
Catalog value : code: "" / ini: 192.168.1.3:8003, 192.168.1.3:8003|myinternalserver:8000, 192.168.1.0/24, 192.168.1.2/32
Technical description (original English : By default, OpenSimulator does not allow scripts to make HTTP calls to addresses on the simulator's LAN. See the OutboundDisallowForUserScripts parameter in OpenSimDefaults.ini for more information on this filter. If you need to allow scripts to make some LAN calls use the OutboundDisallowForUserScriptsExcept parameter below. We recommend that you do not override OutboundDisallowForUserScripts directly unless you are very sure about what you're doing. this HTTP calls can also use ssl see opensimDefaults.ini You can whitelist individual endpoints by IP or FQDN, e.g.
Source code : OpenSim/Framework/OutboundUrlFilter.cs:85
Referenced files:
bin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
port int
Catalog value : code: 0, 9000 / ini: ${Const|PrivatePort}
Technical description (original English : Set by Dreamgrid
Source code : OpenSim/Server/Base/HttpServerBase.cs:63 | addon-modules/21Wifi/WebApp/WebApp.cs:410
Referenced files:
bin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / testbin/Robust.HG.ini— ROBUSTbin/Robust.HG.ini.proto— Template / example / testbin/Robust.Tests.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
shard string
Catalog value : OpenSim
Technical description (original English : What is reported as the "X-Secondlife-Shard" Defaults to the user server url if not set The old default is "OpenSim", set here for compatibility
Source code : OpenSim/Region/CoreModules/Scripting/LSLHttp/UrlModule.cs:131 | OpenSim/Region/ScriptEngine/Shared/Api/Implementation/LSL_Api.cs:462
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
user_agent string
Catalog value : code: "" / ini: OpenSim LSL (Mozilla Compatible)
Technical description (original English : What is reported as the "User-Agent" when using llHTTPRequest Defaults to not sent if not set here. See the notes section in the wiki at http://wiki.secondlife.com/wiki/LlHTTPRequest for comments on adding " (Mozilla Compatible)" to the text where there are problems with a web server
Source code : OpenSim/Region/CoreModules/Scripting/LSLHttp/UrlModule.cs:132 | OpenSim/Region/ScriptEngine/Shared/Api/Implementation/LSL_Api.cs:463
Referenced files:
bin/OpenSimDefaults.ini— Shipped defaultsbin/OpenSim.ini.example— Template / example / testbin/config-include/Proto/OsGrid/OpenSim.ini— Template / example / testbin/config-include/Proto/Region/OpenSim.ini— Template / example / testbin/config-include/Proto/Robust/OpenSim.ini— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.
XFFTrustedProxies string
Catalog value : code: "" / ini: 127.0.0.1|194.32.21.0/24|194.32.100.2|myproxy.org
Technical description (original English : If you have a transparent proxy or proxies, you need to configure them to process http header X-Forwarded-For in a secure way In order for OpenSim to trust them add their addresses (as seen by OpenSim) to this setting You can specify multiple addresses by separating them with a bar Each address can be a hostname (heavier), an IP address or a network range in CIDR format example
Source code : OpenSim/Framework/NetworkXffUtil.cs:57
Referenced files:
bin/OpenSim.ini.example— Template / example / testbin/Robust.HG.ini.example— Template / example / testbin/Robust.ini.example— Template / example / test
This is provenance, not active configuration. Edit only files loaded by your architecture. On a simulator check effective values with config show. .example files must be copied and customized before use.