Verge3D for Maya: Installation — Soft8Soft
Description: This page describes the installation procedure for Maya version of Verge3D. Find you how to setup Verge3D for Maya on Windows, macOS and Linux.

# Installation / Maya

- Prerequisites
- Install Verge3D on Windows
- Install Verge3D on macOS
- Install Verge3D on Linux
- Configuring Plugin Path Manually

#

## Prerequisites

### Maya

Verge3D works on top of Autodesk Maya 2024-2027 which should be installed first. We recommend using the latest compatible version of Maya for maximum features and longer availability period.

### Operating system

We recommend using Verge3D on Windows 11, macOS 11+, or latest Red Hat/Rocky Linux. Make sure you have latest video drivers installed. No admin privileges are required for installation.

### Web browser

Verge3D can work in any browser such as Chrome, Edge, Safari, or Firefox. We, however, recommend to use the Chrome browser for development as it is fast and provides good development tools. You might want to make it your default browser for more convenient previews.

#

## Install Verge3D on Windows

Download the Verge3D bundle and double click on the .exe file to run the installer.

Follow the link to read the recent version of Verge3D license agreement.

Choose components you want to install.

Choose an installation folder that have enough permissions for reading and writing (or better leave it by default).

Wait until the installer finishes copying files to the target directory.

Once installation complete you'll see the following screen.

Now you may open Maya. If you had it running, be sure to close and open it again. Now go to Plug-in Manager settings...

...and activate verge3d.py plug-in by enabling both Loaded and Auto load checkers.

Additionally you can activate gltfExport.py plug-in if you want to export Verge3D scenes via the File → Export All... menu option. Enabling gltfExport.py adds the Verge3D GLTF file type option for the Export All dialog window.

Now you should see Verge3D menu in the main menu bar.

You should now also be able to launch Verge3D's App Manager independently of Maya, by clicking on the desktop icon or using the Start menu.

#

## Install Verge3D on macOS

Download the Verge3D bundle and double click on the .pkg file to run the installer.

Follow the link to read the recent version of Verge3D license agreement.

Then click Agree to accept it.

You can quickly skip the next stage because Verge3D is always installed into the user home folder on macOS.

Wait until the installer finishes copying files.

Once the installation is complete, you'll see the following screen.

Press Close and launch Maya. If you had it running, be sure to close and open it again.

Now go to Plug-in Manager settings

and activate the verge3d.py plug-in by enabling both Loaded and Auto load checkers.

Additionally you can activate gltfExport.py plug-in if you want to export Verge3D scenes via the File → Export All... menu option. Enabling gltfExport.py adds the Verge3D GLTF file type option for the Export All dialog window.

Now you should see Verge3D menu in the main menu bar.

You may also launch the App Manager without running Maya by clicking on the Launchpad icon:

or you can drag-and-drop that launcher right onto your macOS Dock for quicker access:

#

## Install Verge3D on Linux

Download Verge3D XZ bundle and unpack it to a directory of your choice. Make sure you have enough permissions to read/write in this folder. Installing in a system directory is not recommended.

Then go to the VERGE3D_UNPACKED/maya_plugin/setup directory and run the install.py script as follows:

`./install.py install`

The script should print the Maya versions for which the Verge3D plugin is installed.

Restart Maya, open the Plug-in Manager settings and activate the verge3d.py plug-in by enabling both Loaded and Auto load checkers.

Additionally you can activate gltfExport.py plug-in if you want to export Verge3D scenes via the File → Export All... menu option. Enabling gltfExport.py adds the Verge3D GLTF file type option for the Export All dialog window.

Now you should see Verge3D menu in the main menu bar.

#

## Configuring Plugin Path Manually

Sometimes Verge3D menu won't show up. This may happen due to various reasons:

- You disabled the Auto-Configure option in the installer.
- You installed and running an unsupported version of Maya.
- You switched Windows user.

In such the case, you may use the following procedure to configure the plugin path manually.

Find the file named Maya.env which is typically located in on the following folders:

- Windows — \Users\user\Documents\maya\VERSION
- macOS — $HOME/Library/Preferences/Autodesk/maya/VERSION
- Linux — $HOME/maya/VERSION

Edit this file to specify the MAYA_PLUGIN_PATH environment variable. For example, if you installed Verge3D to the verge3d_maya folder inside the home folder (on Windows, hence the backslashes), put:

`MAYA_PLUG_IN_PATH=\Users\user\verge3d_maya\maya_plugin`

Save the file and open Maya. If you had it running, be sure to close and open it again. Locate the Verge3D plugin in the Plug-In Manager settings dialog. Activate it by clicking the both Loaded and Auto load checkers. Now you should see Verge3D menu in the main menu bar.

## What's Next

Familiarize yourself with the basics!

## Got Questions?

Feel free to ask on the forums!