A local server lets you use your own computer to host your virtual domain on the metaverse.
Hosting any kind of server from your home means exposing your network to the world. Therefore, we recommend using local servers only for private events and small gatherings. If you want to host a public domain or advertise your domain in the Explore app, we recommend using a cloud hosting provider such as DigitalOcean.
On This Page
Before you set up a local server, you should have a basic understanding of computer and networking concepts. Specifically, familiarize yourself with:
Your system and hardware configuration
Your network configuration
At a minimum, the computer that you use for your server should meet our minimum system requirements. However, keep in mind that as you add more visitors to your domain, the demand on your resources will increase. Therefore if you wish to invite a large group (over 15 visitors) or create a complex content set, we encourage you to increase your memory and network bandwidth.
To host a domain on Windows, you must be running Vircadia's open source Client + Server software.
To set up a domain and host it on your local server:
Open the Setup Wizard (Domain Server Settings).
For local servers on Windows: Click on the Vircadia icon in the system tray, then click 'Settings'.
For local servers running on any OS, go to http://localhost:40100/settings.
Follow the steps of the Wizard to create a domain on the metaverse and connect it to your local server.
Step 1: Connect your Metaverse account: When you connect your account, you become the owner of the new domain ID that is created for your server. The security token that you copy and paste gives the Metaverse Server access to your domain settings, which are stored on your local server.
Step 2: Create Place name: Your Place name is how users will visit your domain in the metaverse. Alternatively, they can enter your domain's ID or IP address into the Explore app.
Step 3: Set up basic permissions: By default, anyone logged on to your computer will have full access to your domain. If you would like to extend administrator privileges to remote users (or allow yourself access from a remote location), then add the Vircadia Metaverse usernames here. In addition, choose who will be able to connect or rez items.
Click Finish to close the Setup Wizard. You will automatically be redirected to the Domain Settings for your domain.
At this point, you have staged a domain in the metaverse and connected it to your server. However, it is not yet "live", meaning that it exists only as a temporary or "draft" domain in the metaverse.
To activate your domain:
Return to the Domain Settings for your domain. If it isn't open, open a browser window and type http://localhost:40100/settings/ into the URL bar.
Click 'Advanced Settings' under Metaverse/Networking.
Click the 'Create new domain ID' button.
This will assign your domain with a permanent, unique identification code that registers it in the metaverse. Your domain will now be accessible through the Place name or your server's IP address.
If you did not assign a Place name, the only way to access your domain is by your server's IP address. However, note that when your IP address changes, so too will the address of your domain. Therefore, if you are hosting your domain on a laptop or on a computer with a frequently changing IP address, we strongly recommend that you configure a Place name for your domain. Learn how to configure a Place name.
Now, your domain is officially part of the expanding metaverse!
Visit Your Domain
Personalize Your Content
Configure More Settings