Skip to content

Server Maintenance and User Management

This page covers practical maintenance tasks that map closely to OpenSimulator console commands exposed through opensim-console2mcp.

Region operations

Create a region:

create region "Region Name" Regions/RegionName.ini

Show regions:

show regions

Restart current region:

restart

Schedule restart with notice:

region restart notice "Maintenance in progress" 300 60 30

Abort a scheduled restart:

region restart abort "Restart canceled"

User management

Create user:

create user First Last Password email@example.com

Show account:

show account First Last

Reset password:

reset user password First Last NewPassword

Kick user:

kick user First Last --force "Maintenance"

Import and export resources

Export region to OAR:

save oar /workspace/exports/region-backup.oar

Import region from OAR:

load oar /workspace/imports/region-restore.oar

Export user inventory (IAR):

save iar First Last / Password /workspace/exports/user.iar

Import user inventory (IAR):

load iar First Last / Password /workspace/imports/user.iar

Terrain and scene maintenance

Set water height:

set water height 25

Backup pending object changes:

backup

Show scene stats:

show scene

Runtime operations from Docker host

Restart one service:

docker compose restart opensim

Restart full stack:

docker compose restart

Inspect recent logs:

docker compose logs --tail 200 opensim

High-impact commands

Commands like load oar, object deletion, or scene transforms can be destructive. Take backups first.