OpenSimulator · EN

OpenSimulator ports and networking

ROBUST public/private, simulators, TCP/UDP, DNS, NAT, UFW firewalls and tests.

Examples checked against the OpenSimulator 0.9.3.1 / .NET 8 fork configuration files. Adapt domains, IPs, ports and firewall rules. Back up before changing production systems.

Ports are configuration-dependent

The values below are samples from the 0.9.3.1 fork: 9000 for Standalone and a first region, 8002 public ROBUST and 8003 private ROBUST. Regions and simulator instances may use other ports. Inventory your actual configured ports, including optional voice, money and web modules.

Recommended traffic flows

8002/TCP: public ROBUST services when that port is configured, including public HG connectors in HG mode. 8003/TCP: internal ROBUST connectors, restrict to trusted hosts. 9000/TCP and UDP: common first-region example; verify actual region and simulator HTTP ports. These are not an exhaustive list for custom grids.

InternalAddress, InternalPort, ExternalHostName

InternalAddress is a bind address; 0.0.0.0 binds available interfaces. InternalPort is the region port. ExternalHostName is the address advertised to viewers. A template value of SYSTEMIP does not guarantee the right public address behind NAT or inside a VM.

Adapt this example: do not apply it blindly.

[MaRegion]
InternalAddress = 0.0.0.0
InternalPort = 9000
ExternalHostName = region.example.org

Prepare DNS and NAT

Configure public DNS for ROBUST or Standalone and for regions if applicable. Behind NAT, forward traffic to the correct private host. Update DNS and published configuration when IPs change. A local firewall rule does not replace hosting-provider firewall rules.

UFW: sample grid port rules

EXAMPLE for a host serving public ROBUST services and a region on 9000. Adapt to actual ports, service locations and provider firewall. Preserve SSH rules before enabling UFW. The private port below is allowed only from a trusted simulator IP.

Adapt this example: do not apply it blindly.

# Exemple seulement ; UFW déjà actif et accès SSH préservé
sudo ufw status numbered
sudo ufw allow 8002/tcp
sudo ufw allow 9000/tcp
sudo ufw allow 9000/udp
# Adresse privée réelle d'un simulateur autorisé :
sudo ufw allow from 10.0.0.20 to any port 8003 proto tcp
sudo ufw status

Multiple regions or simulator processes

Each region needs consistent parameters in Regions/*.ini. For several regions, verify their individual ports and each simulator process HTTP listener; avoid port conflicts. Across VMs, permit private ROBUST traffic between hosts but not from the Internet.

Additional money and voice services

Do not confuse custom currency, web APIs and WebRTC ports with OpenSimulator core ports. For the optional BloodMoon Voice component, example ports are TCP 9443 for TLS signaling and UDP 40000–40999 for media. OpenSimulator itself does not require these ports without that service.

Test ports and DNS

Test DNS resolution, bound sockets and reachability from a separate network. An open TCP port does not prove ROBUST connectors are configured or a viewer can complete login. For UDP failures, check NAT and region logs.

Adapt this example: do not apply it blindly.

getent hosts grid.example.org
ss -lntup
sudo ufw status
# Depuis un autre hôte autorisé :
curl -v http://grid.example.org:8002/

Do not publish private services

Restrict private ROBUST endpoints, SQL, SSH, monitoring and administration to trusted networks. Do not expose private HTTP services to solve a misconfigured network.

Detailed sources