Install OpenSimulator: start here
Choose an architecture before copying files: a local simulator is not the same as a distributed grid.
Scope and versions
These paths target OpenSimulator 0.9.3.1 source on .NET 8 for Windows, Linux or macOS where the required dependencies are supported. Ubuntu 24.04 is only an example Linux environment. Other variants, binary distributions and third-party modules may differ. Validate on your own host.
Standalone or Grid?
Standalone hosts regions and core services in one process: the simplest way to learn and create a first region. Grid runs ROBUST central services and separate OpenSim simulator processes. Separate physical machines are optional.
Prepare the host
Prepare an unprivileged Linux account, secure SSH access, disk space for assets and backups, consistent DNS and free ports. A public setup needs stable DNS and firewall policies.
File and directory structure
OpenSim.ini, Robust.ini and the config-include and Regions directories normally live under bin/. .example files are templates, not automatically active. Keep customized settings separate and backed up.
Install SDK and build
The repository provides runprebuild.sh and OpenSim.sln. Check .NET version before building and follow BUILDING.md. Build the exact source revision you intend to run. The following commands are Linux examples; use the platform guide for Windows and macOS.
Adapt this example: verify paths, hostnames, permissions and settings.
sudo apt update sudo apt install -y git curl ca-certificates libgdiplus libc6-dev dotnet --info # Installer le SDK .NET 8 via les paquets Microsoft si absent. git clone https://github.com/Vlad-BloodMoon/opensim.git cd opensim ./runprebuild.sh dotnet build --configuration Release OpenSim.sln
Build versus runtime
A machine with the .NET 8 runtime can run an existing compatible build, but compiling from GitHub requires the .NET 8 SDK. The source's Linux procedure starts OpenSimulator from bin with opensim.sh.
Adapt this example: verify paths, hostnames, permissions and settings.
cd bin ./opensim.sh
Security before public access
Do not expose MySQL, administrative SSH or private ROBUST ports to the public. Limit network access to required flows, replace example credentials and test locally or over a private network first.