Vircadia has two different installers. The Client Installer comes with everything you need to view and interact with Vircadia's content and users. However, you are unable to host content using this installer. The Client + Server Installer has everything the client installer does, but it also enables you to host your own content and share it with the world. The Client + Server Installer download is only provided for Windows. For Linux see: Host a Domain from a Local or Cloud Linux Server.
On This Page
In order to run Vircadia, ensure that your computer meets these system requirements:
Windows 8.1, 64-bit or Windows 10, 64-bit
MacOS High Sierra (10.13) or newer
Ubuntu 18.04 64 bit or most other modern Linux distributions
Recommended: Quad-core with hyper-threading or better
Minimum: Nvidia 600 series
Recommended: Nvidia 900 series or higher
Minimum: AMD Radeon HD 87XX series
Recommended: AMD Radeon HD 89XX series or higher
Minimum: Intel 5th generation CPU integrated Iris graphics. Using Intel integrated graphics is not recommended.
The listed graphics adapters support OpenGL 4.1 and above. This is a requirement for any graphics adapter running Vircadia.
In addition, your network must have enough internet bandwidth to run Vircadia:
If you are using Interface only to explore the metaverse, then you should have Internet speeds of at least 10 Mbit/s download and 2 Mbit/s upload.
If you are hosting a domain server on a remote machine or your local computer, you need to add 10 Mbit/s upload for each user that you want to allow to concurrently visit your domain. You will need only 2 Mbit/s upload per user if you host your assets on an external web server rather than your domain server.
A world that is specifically built for low-end systems might run fine on a system with slightly less memory or a lower CPU core count.
Running Vircadia on a high resolution display or in VR mode will need a much better graphics adapter, depending on your display's resolution and targeted frame rate.
If you intend to use Vircadia in VR mode with an HMD, ensure that SteamVR or Oculus Runtime is also installed on your system before launching Vircadia. VR mode is not supported on macOS. The Oculus Runtime is not supported on Linux.
Once you've downloaded the installer, you're ready to install Vircadia. The process will be different based on your operating system:
To install on Windows, simply double-click on the downloaded installer file to open it. Run through the prompts on the installer. Once you finish the install process, Interface will open, and you will be able to log in and begin exploring the metaverse.
At this time, the Vircadia installer for Mac is unsigned, so you will need give the OS permission to install the application.
Open the downloaded installer dmg file.
Agree to the License Agreement.
Drag Vircadia to the Applications folder.
Try opening Interface.app. You will be prompted that macOS will not open the file because it is unsigned.
Open System Preferences > Security & Privacy. On older macOS versions this might be in System Preferences > General.
Next to the warning indicating that Interface is blocked, click 'Open Anyway'.
Confirm that you want to open the application.
Allow microphone access if prompted, in order to be able to talk inside the application.
At this point, Interface will open and you will be able to log in and begin exploring the metaverse.
Mark the downloaded AppImage file as executable. (for example, with
chmod +x Vircadia-x86_64_v2021.1.0-Eos.AppImage.)
(Optional) If you want the AppImage to be integrated into your system, install AppImageLauncher.
Currently the server is not part of the Linux Interface AppImage. To host a domain, please refer to Host a Domain from a Local or Cloud Linux Server.
Vircadia is always changing, as we work to improve performance and add features that will enhance your experience in the metaverse. At any time, you can download the latest release from our website.
You cannot upgrade Vircadia on Windows if you have Vircadia Interface or Server running on your computer. Be sure to quit these applications before upgrading. Keep in mind that Vircadia Server could be running in the background.
For Windows, locate the Vircadia app in your system tray. Right-click on the icon and select 'Quit'. Alternatively, end the 'server-console' background process using the Task Manager.
For more information on the latest releases, see our Release Notes.
If you're facing problems when you load Interface or the local Server, then you can try performing a clean install. A clean install removes multiple files and settings that you may need once you install Vircadia again.
Ensure that you back up the following files before a clean install: Favorites, Wearables, Server content, and Entities. These settings will be deleted during the clean install.
Windows Clean Install¶
Click on the Start menu and type "Add or Remove Programs" in your Windows search bar.
Uninstall any versions of Vircadia that are visible.
Once Vircadia is uninstalled, browse to your %Program Files% directory. Delete all folders related to Vircadia.
The next 3 steps will permanently delete your local Server's content. If you wish to keep this content, copy %AppData%/Local/Vircadia/assignment-client to another location on your computer before proceeding. Repeat for %AppData%/Roaming/Vircadia/assignment-client.
Browse to your local %AppData% folder (usually
C:/Users/<your_username>/AppData/Local). If you do not see the folder, make sure you can view hidden folders: in File Explorer, click View and make sure "Hidden Items" is checked. Delete all folders related to Vircadia.
Browse to your roaming %AppData% folder (usually
C:/Users/<your_username>/AppData/Roaming). Delete all folders related to Vircadia.
Re-install Vircadia using the steps above. To restore your local Server's content, copy the
assignment-clientfolders you previously saved back into to their respective locations.
Mac Clean Install¶
Open your Applications folder and delete the Vircadia folder.
<username>/.configfolder. This is a hidden folder than is accessible by going to Go > Home. Press the keyboard shortcut
Command + Shift + .(period).
~/Libraryfolder by holding the Option key and clicking the 'Go' menu while in the Finder. The Library option should appear in the menu.
~/Library/Application Supportand delete the Vircadia folder.
Empty the Trash.
Re-install Vircadia using the steps above.