OpenSimulator · EN

Install OpenSimulator: start here

Choose an architecture before copying files: a local simulator is not the same as a distributed grid.

Learning path for OpenSimulator 0.9.3.1 / .NET 8. Adapt domains, secrets, versions and ports to your installation. Verify source files before production.

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.

Next steps and references

Configure ports and firewall

Install Hypergrid