User Tools

Site Tools


en:technical:self_hosting:self_hosted_windows

Self-Hosting on Windows

administrator technical

Guide to hosting your own OpenSimulator region on Windows.

Introduction

Self-hosting allows you to run your own OpenSimulator region on your own hardware, giving you complete control over your virtual space. This guide covers setting up OpenSimulator on Windows for connecting to Caprica or running independently.

What You'll Learn: * System requirements * Installing OpenSimulator * Basic configuration * Connecting to Caprica * Trouleshooting common issues

Before You Begin: * Basic understanding of Windows administration * Comfortable with command line * Basic networking knowledge * Time commitment for setup and maintenance

System Requirements

Minimum Requirements

Hardware: * CPU: Quad-core processor (Intel i5 or AMD equivalent) * RAM: 8GB minimum, 16GB recommended * Storage: 50GB free space (SSD recommended) * Network: Stable broadband connection with good upload speed

Software: * Windows 10 or Windows Server 2016+ * .NET Framework 4.7.2 or later * Database software (MySQL, MariaDB, or SQLite for testing)

Hardware: * CPU: Hexa-core or better * RAM: 32GB+ * Storage: 100GB+ SSD * Network: Dedicated connection with static IP preferred

Software: * Windows Server 2019/2022 * MySQL or MariaDB for production * Apache or IIS for web services

Prerequisites

Software Installation

.NET Framework: 1. Download and install .NET Framework 4.7.2 or later 2. Verify installation in Windows Features

Database: For Testing: * SQLite (included with OpenSimulator) * No additional installation needed

For Production: * MySQL: Download from mysql.com * MariaDB: Download from mariadb.org * Install and configure during setup

Firewall Configuration: 1. Open Windows Firewall with Advanced Security 2. Allow inbound connections for:

  • Port 9000 (OpenSimulator)
  • Port 8002 (Robust services)
  • Port 8003 (Robust services)
  • Port 8895 (web services, if used)

Downloading OpenSimulator

Official Sources

OpenSimulator Website: * Visit: http://opensimulator.org/ * Navigate to Downloads * Choose Windows version

Binaries vs Source: * Binaries: Pre-compiled, ready to run (recommended) * Source: Requires compilation, for developers

Stable vs Development: * Stable: Tested, reliable (recommended for production) * Development: Latest features, may have bugs

Downloading Binaries

1. Download the latest stable Windows binary 2. Extract to a directory (e.g., C:\OpenSimulator) 3. Keep the path simple (no spaces or special characters)

Initial Configuration

Basic Setup

Directory Structure: ``` C:\OpenSimulator\ ├── bin\ ├── bin\OpenSim.exe ├── bin\OpenSim.32BitLaunch.exe ├── bin\OpenSimConsole.exe └── bin\OpenSim.Server.exe ```

First Run: 1. Open command prompt as Administrator 2. Navigate to bin directory: `cd C:\OpenSimulator\bin` 3. Run: `OpenSim.exe` 4. First-time setup wizard will launch

Configuration Wizard

Region Configuration: 1. Choose region name 2. Set region location (X, Y coordinates) 3. Set region size (usually 256×256) 4. Set internal IP address (127.0.0.1 for local)

Database Configuration: 1. Choose database type (SQLite for testing, MySQL for production) 2. If MySQL:

  • Enter database name
  • Enter database user
  • Enter database password
  • Enter database host (localhost)

Network Configuration: 1. Set external IP address (your public IP) 2. Set external port (9000) 3. Enable Hypergrid if desired

Configuration Files

OpenSim.ini

Located in `bin\OpenSim.ini`

Key Settings: ```ini [Startup] gridmode = true physics = basicphysics

[Network] http_listener_port = 9000 user_agent = “OpenSim Server”

[StandAlone] … ```

Network Settings: ```ini [Network] ExternalHostName = “your-public-ip.com” InternalAddr = “127.0.0.1” InternalPort = 9000 ```

Region Configuration

Located in `bin\Regions\YourRegion.ini`

Basic Settings: ```ini [YourRegion] RegionUUID = <auto-generated> Location = 1000, 1000 InternalAddress = 0.0.0.0 InternalPort = 9000 AllowAlternatePorts = False ExternalHostName = “your-public-ip.com” ```

Connecting to Caprica

Grid Mode Configuration

To Connect to Caprica: 1. Configure OpenSimulator in grid mode 2. Add Caprica as a grid 3. Configure robust services

OpenSim.ini Changes: ```ini [Startup] gridmode = true

[Architecture] Include-Architecture = “Grid”

[GridService] StorageProvider = “OpenSim.Data.MySQL.dll” ConnectionString = “Data Source=localhost;Database=opensim;User ID=opensim;Password=yourpassword;” Realm = “regions”

[AuthenticationService] … ```

Caprica-Specific Settings

Login URI: ``` https://g.caprica.xyz:9000 ```

Add to OpenSim.ini: ```ini [GridInfo] gridname = “Your Region Name” gridnick = “yourregion” loginuri = “https://g.caprica.xyz:9000” ```

Contact Caprica Administrators: * Get specific connection details * Request grid access * Obtain configuration parameters

Running OpenSimulator

Starting the Server

GUI Mode: 1. Double-click `OpenSim.exe` 2. Console window will open 3. Wait for “Startup complete” message

Console Mode: 1. Open command prompt 2. Navigate to bin directory 3. Run: `OpenSimConsole.exe` 4. Server runs in command prompt

Service Mode (Advanced): 1. Use NSSM (Non-Sucking Service Manager) 2. Install OpenSimulator as Windows service 3. Set to auto-start

Verifying Startup

Successful Startup Indicators: * “Startup complete” message * No critical errors * Services listening on configured ports * Region appears in list

Common Issues: * Port already in use * Database connection failed - Configuration errors - Permission errors

Maintenance

Backups

Database Backups: * Regular database dumps - Automated backup scripts - Off-site backup storage

Content Backups: * Backup `bin` directory - Save OAR (OpenSimulator Archive) files - Backup configuration files

Backup Script Example: ```batch @echo off set BACKUP_DIR=C:\Backups\OpenSimulator set DATE=%date:~-4,4date:~-7,2date:~-10,2% mysqldump -u opensim -p opensim > %BACKUP_DIR%\opensim_%DATE%.sql ```

Updates

Updating OpenSimulator: 1. Stop the server 2. Download new version 3. Backup current installation 4. Replace files 5. Run any migration scripts 6. Restart server

Compatibility: * Check release notes - Test in staging environment - Plan for downtime

Troubleshooting

Common Issues

Server Won't Start: * Check if port 9000 is already in use - Verify database is running - Check configuration files - Review logs in `bin\logs\`

Can't Connect: * Verify firewall settings - Check external IP is correct - Ensure server is running - Test connectivity

Performance Issues: * Monitor CPU and RAM usage - Check database performance - Reduce script time - Optimize region settings

Database Errors: * Verify database is running - Check connection string - Ensure database user has permissions - Check disk space

Logs

Log Location: `bin\logs\OpenSim.log`

Reviewing Logs: * Look for ERROR messages - Check for WARNING messages - Review startup sequence - Note any failed services

Security Considerations

Basic Security

Firewall: * Only open necessary ports - Use whitelisting if possible - Regularly review rules

Authentication: * Use strong passwords - Change default passwords - Limit administrative access

Network: * Use VPN for remote administration - Encrypt sensitive data - Regularly update software

Best Practices

* Keep software updated - Use strong authentication - Regular backups - Monitor logs - Implement access controls - Use HTTPS for web services

Advanced Topics

Multiple Regions

Adding More Regions: 1. Copy existing region configuration 2. Modify for new region 3. Set unique coordinates 4. Restart server

Region Map: * Plan region layout - Coordinate with neighbors - Consider teleport routing

Robust Services

What Are Robust Services: * Separated services for grid functionality - Better scalability - Improved reliability

Setting Up: * Install Robust services - Configure OpenSim.ini - Update connection strings

Resources

Official Documentation

* OpenSimulator Wiki: http://opensimulator.org/wiki/ * OpenSimulator Forums: http://opensimulator.org/forum/ * Caprica Documentation: https://caprica.xyz/

Community Resources

* OpenSimulator Discord - Grid operators mailing lists - Caprica community forums

Next Steps

Now that you have OpenSimulator running:

* Test basic functionality - Connect to Caprica (if desired) - Configure additional regions - Set up regular backups - Monitor performance

Self-hosting gives you complete control, but requires ongoing maintenance. Start simple and scale as needed!

en/technical/self_hosting/self_hosted_windows.txt · Last modified: 2026/11/07 11:50 (external edit)

Page Tools