Install OpenSimulator on your operating system
Windows, Linux (Ubuntu, Debian and other compatible distributions) and macOS: shared concepts, platform-specific commands.
Common prerequisites
Building from source requires the .NET 8 SDK. Running a compatible precompiled build may only require the .NET 8 runtime. Native dependencies and tools vary by operating system.
Check the installed .NET version.
dotnet --info
Linux: Ubuntu and Debian
These commands illustrate an APT-based distribution. They do not directly apply to Fedora, Arch or others. Install the .NET 8 SDK using your distribution’s supported method, then build from source.
Debian/Ubuntu Linux example: .NET 8 SDK must already be installed.
sudo apt update\nsudo apt install -y git libgdiplus libc6-dev\ndotnet --list-sdks\n# Depuis la racine des sources OpenSimulator :\n./runprebuild.sh\ndotnet build --configuration Release OpenSim.sln\ncd bin\n./opensim.sh
Linux: other distributions
The principle is the same: install the .NET 8 SDK and equivalent native dependencies, generate the solution, then build. Adapt package-manager commands: apt is not universal.
Windows
BUILDING.md requires the .NET 8 SDK. From a Windows terminal at the source root, execute runprebuild.bat, then build OpenSim.sln with .NET tools or Visual Studio. The README documents launching OpenSim.exe from bin.
Example build and launch on Windows.
runprebuild.bat\ndotnet build --configuration Release OpenSim.sln\ncd bin\nOpenSim.exe
macOS
BUILDING.md groups Linux and macOS for project generation and compilation. Verify SDK availability and native libraries for your architecture, then use the bundled scripts. apt commands do not apply to macOS.
Generic commands; verify compatibility and script permissions.
./runprebuild.sh\ndotnet build --configuration Release OpenSim.sln\ncd bin\n./opensim.sh
What stays the same across systems
Standalone / Grid architecture, OpenSim.ini and Robust.ini, central services, regions and network principles are shared concepts. Paths, permissions, firewalls, service managers and shell commands depend on the platform.