OpenSimulator OAR Help

How to Load an OAR

The command itself is easy. The confusing part is finding the correct OAR manager or OpenSim console. Choose the setup you actually use below.

Back up the destination region first

A normal OAR load can replace terrain, parcels, and objects in the destination region. Save a backup OAR before loading a new one unless you specifically understand and intend to use merge/displacement options.

Choose how your OpenSim is hosted

Jump directly to the instructions that match your setup.

Hosting4OpenSim / H4OS DreamGrid Other Hosting Provider Self-Hosted OpenSim

Hosting4OpenSim / H4OS

You normally do not need to find a raw server console. Use the OAR tools in your H4OS control panel for the destination region.

Sign in to your Hosting4OpenSim/H4OS customer panel.
Open the region where you want the OAR loaded and open its OAR Manager or import/load-OAR tool.
If the OAR page on TheOarShop gives you a Public OAR URL, choose the option to import/load from a URL and paste it. For a purchased/private OAR, download it first and use the upload option provided by your panel.
Confirm the destination region and start the load. Wait for the operation to finish before restarting or editing the region.
Log in or return to the region and verify terrain, parcels, objects, and scripts.

If the exact button names differ in your H4OS version, choose the region-management option for OAR backup/restore/import. The important part is selecting the correct destination region before starting.

DreamGrid

DreamGrid includes GUI controls for loading OARs, so most users can avoid typing console commands entirely.

Open DreamGrid and make sure your grid/region is running.
Open the Region List and select the destination region.
Use Load Region OAR for that region, then choose the OAR you downloaded. DreamGrid also has a built-in Free OAR browser for content it provides directly.
If you specifically need the console, the region panel provides View Console. In service mode, DreamGrid can use its ConsoleClient to connect to the hidden OpenSim console.
Wait for the OAR load to finish, then visit the region and verify the result.

DreamGrid Region List / Load Region OAR help ↗

Another OpenSim hosting provider

Every provider can expose OAR loading differently. Look for an OAR, backup, restore, region management, or console feature in your hosting panel.

Sign in to your hosting provider's control panel.
Select the exact region where the OAR should be loaded.
Look for OAR Manager, Load/Restore OAR, Region Backup, or Console.
If the panel supports OAR uploads, download the OAR from TheOarShop and upload it there. If it supports loading from URL, paste the public OAR URL for a Free OAR.
If you cannot find an OAR or console feature, contact your provider and ask: “How do I load an OpenSimulator OAR into my region?” Send them the downloaded OAR if they perform restores for customers.

Do not assume a generic SSH or web-terminal login is the OpenSim region console. Your provider may intentionally hide the raw console and offer a safer OAR restore tool instead.

Self-hosted OpenSimulator

If you run OpenSim yourself, use the console window/session for the simulator process that owns the destination region.

Open the region console. This is the terminal, DOS/PowerShell window, tmux/screen session, system service console client, or other shell attached to the OpenSim process — not your viewer's local chat.
Select the destination region.
```
change region YourRegionName
```
Load the OAR. For a local file, give OpenSim the path it can read:
```
load oar /path/to/your-region.oar
```
For a Free OAR that your OpenSim build can load from an HTTPS URL, you can use the Public OAR URL shown on the OAR page:
```
load oar https://theoarshop.com/...
```
Wait for the console to report that loading has completed. Large OARs can take time.
Log in or teleport away and back, then verify the region.

Common problems

Wrong destination regionUse the region selector or change region before loading. Loading into the wrong region can overwrite content there.

OAR size mismatchCheck the OAR region dimensions on TheOarShop. Varregions and multi-region OARs can require different placement or displacement options.

Objects look missingWait until the load finishes. Then re-log or teleport away and back so your viewer refreshes the scene.

No console accessUse your provider's OAR restore/import tool or ask support to load the OAR for you. You do not necessarily need raw console access.

Browse Free OARs Browse OpenSim OAR Marketplace Back to Home

Need Help?

If you run into any issues or have questions about loading your OAR, our support team is here to help.

Submit a Ticket