🇬🇧

Documentation

Glossary

Download and installation#

Open Download on the Production Assist website or go directly to the Download page. You do not need an account to download the desktop app. You can create an account afterward to sign in and work with online projects.

On the Download page, choose the installer for your operating system. The desktop app is available for Windows, macOS, and Linux. The same page also has downloads for integrations such as the Vectorworks plug-in.

For a tablet or smartphone, choose the appropriate store link in the Production Assist for Tablet / Smartphone card. App Store and Google Play open the relevant store in a new tab.

Wide desktop view of the Download page with cards for Windows, macOS, Linux, and tablet/smartphone, and Production Assist version 2026.1


Installing the Production Assist app#

Windows#

On Windows, you can choose between the installed and portable desktop apps.

Installed desktop app#

On the Download page, select Desktop App and download the EXE file. It is saved automatically in the Downloads folder. Double-click it to start the installation. You can choose the installation folder during setup.

After installation, you can start Production Assist from the Windows Start menu. The program files are in the folder you chose during installation.

By default, the installed desktop app stores user data in %APPDATA%\ProductionAssist.

Portable desktop app#

The portable desktop app is available only for Windows. It does not require installation and can be started, for example, from a USB drive or a custom program folder.

  1. On the Download page, select Portable Desktop App.
  2. Extract the downloaded archive ProductionAssist-VERSION-portable.zip completely into a folder where you have write permission.
  3. Double-click ProductionAssist.exe in the extracted folder to start it. Keep the other files and the .productionassist-portable marker in this folder.

On first launch, the ProductionAssist-data folder is created automatically next to ProductionAssist.exe. This keeps the user data of the installed and portable desktop apps separate. The portable folder structure includes, among other things:

ProductionAssist.exe
.productionassist-portable
resources/                  other program files
ProductionAssist-data/
├── session/          session and browser data
├── logs/             log files
├── local-resources/  local resources
├── temp/             temporary files
├── mesh/             temporary geometry data
└── Resource/         cached resources

Important: Move or back up the entire extracted program folder together with ProductionAssist-data. Without .productionassist-portable next to the program file, Production Assist does not recognize this as a portable launch. If Production Assist cannot create folders or files in the data directory, the portable app will not start; it does not fall back to the normal AppData directory.

The following special conditions apply to the portable desktop app:

  • Automatic updates are disabled. To update, download a new portable ZIP archive. Close the app and replace the existing program files with the contents of the new archive. Keep the ProductionAssist-data folder.
  • The productionassist: URL protocol is not registered in Windows.
  • The standard Windows Downloads folder is still used as the download directory.
  • To use the portable desktop app with a Production Assist plug-in, point the plug-in to the ProductionAssist-data folder. See Configure the plug-in AppData directory.

macOS#

  1. Download the macOS DMG file from the Download page and double-click it to open it.
  2. In the open DMG window, drag ProductionAssist to Applications. This copies the app to the Applications folder.
  3. Open ProductionAssist from the Applications folder.

Drag ProductionAssist in the DMG window to the Applications folder

Note: If macOS reports on first launch that ProductionAssist was downloaded from the internet, confirm the prompt by clicking Open.

macOS prompt to open the app downloaded from the internet

Linux#

Production Assist is provided for Linux as an AppImage file. Download it from the Download page. The app is tested on the current Ubuntu LTS release and on Manjaro. You can integrate the AppImage into your applications menu with AppImageLauncher or run it directly.

Integrate with AppImageLauncher#

AppImageLauncher is an additional application. If you use it, you can integrate the downloaded Production Assist AppImage into the applications menu the first time you open it.

  1. First check whether AppImageLauncher is already installed. It is preinstalled in many Manjaro editions.
  2. If AppImageLauncher is missing, on Ubuntu download the appropriate .deb package from the AppImageLauncher releases page and install it with the package manager. For Arch and Manjaro, find the current installation methods in the AppImageLauncher guide. The previously used Ubuntu PPA is no longer offered.
  3. Open the downloaded Production Assist AppImage file and choose integration in the AppImageLauncher dialog. You can then start Production Assist from the applications menu.

Run the AppImage directly#

If you do not want to use AppImageLauncher, make the downloaded AppImage file executable. To do this, right-click the file and, on Ubuntu, open Properties → Permissions. Enable Allow executing file as program, then double-click the AppImage file. It starts from its current location.

Older Ubuntu example (Production Assist AppImage 1.5.0): enable execution permission for an AppImage file

On KDE (Manjaro), find the option under Properties → Permissions → Executable.


Installing the Production Assist Vectorworks plug-in#

To install the plug-in, you must also have the installed or portable desktop app and run it at least once. If you use the portable desktop app, you must also configure the plug-in's AppData directory.

There are two ways to install the plug-in: with the Production Assist app or manually. For a manual installation, you need to find the Vectorworks user folder for the desired version. The Production Assist app detects installed Vectorworks versions automatically.

With the Production Assist app#

  1. Start the Production Assist desktop app. You do not need to sign in to open the installation dialog. You need an internet connection to download the plug-in.
  2. In the menu bar, select Help → Install Vectorworks Plug-in....
  3. In the Install Plugins dialog, select the detected Vectorworks version. Versions without a detected Vectorworks installation cannot be selected; versions that are already installed are marked Currently installed. Use Show at next start to choose whether the installation dialog should be offered again when needed the next time the app starts.
  4. Confirm the dialog. Wait for the Installation successful message, then restart Vectorworks to load the plug-in. If Installation failed appears, check your internet connection and the selected Vectorworks version, then try the installation again.

If Production Assist reports Version conflict detected, the loaded plug-in version does not match the user interface version. Update the desktop app and reinstall the matching Vectorworks plug-in. The dialog shows the detected versions and paths.

Before installation, Production Assist checks whether Vectorworks is already running. While Vectorworks is open, you cannot select Vectorworks plug-ins. Quit Vectorworks and click Check again in the dialog so Production Assist can update the status.

Before installation, Production Assist checks whether Vectorworks is already running. While Vectorworks is open, you cannot select Vectorworks plug-ins. Quit Vectorworks and click Check again in the dialog so Production Assist can update the status.

When extracting files, Production Assist checks the package size information. Each file can be at most 256 MiB compressed and 512 MiB uncompressed. Each selected package folder can contain at most 2 GiB compressed and 2 GiB uncompressed in total. If an entry exceeds these limits or its size information does not match, installation is cancelled. Contact support about such a package.

Manually#

Windows#

  1. On the Download page, select Windows and Vectorworks Plug-in.
  2. Select your installed Vectorworks version from the drop-down menu.
  3. Download and extract the offered ZIP file.

The ZIP file contains only the plug-in for the selected Vectorworks version and the shared Production Assist files it needs. For manual installation, you need the Plug-ins folder for your Vectorworks version. If you want to use the folder in the program directory and do not know its location in Windows, search for Vectorworks in the Start menu, right-click the program entry, and use Open file location to open the path to the application.

The image shows an older package as an example. In the current archive, always choose the folder for the Vectorworks version you actually have installed.

Copy the ProductionAssistWeb folder and ProductionAssist.vlb and ProductionAssist.vwr from the folder for your Vectorworks version into its Plug-ins folder. For your user account, this folder is at %APPDATA%\Nemetschek\Vectorworks\<Year>\Plug-ins; replace <Year> with the version number. Alternatively, you can use the Plug-ins folder in the Vectorworks installation folder.

You can now start Vectorworks.

macOS#

  1. On the Download page, select macOS and Vectorworks Plug-in.
  2. Select your installed Vectorworks version from the drop-down menu.
  3. Download the offered ZIP file.

CAUTION: Apple adds a quarantine attribute to downloads from outside the App Store. Temporarily remove it before installing the plug-in. Open Terminal and enter xattr -d com.apple.quarantine. Add a space, then drag the downloaded ZIP file into the Terminal window. Check that there is a space between the command and the file path, then press Enter.

Older Terminal example for quarantine: the required space is missing before the file path; see the corrected command in the note

Now double-click the ZIP file in your Downloads folder to extract it. In the extracted archive, open the folder for your Vectorworks version and copy ProductionAssist.vwlibrary.

The image shows the VW21 folder as an example. In the current archive, choose the folder for the Vectorworks version you have installed.

Go to your Vectorworks user folder at ~/Library/Application Support/Vectorworks. Select your Vectorworks version and place ProductionAssist.vwlibrary in the Plug-ins folder.

The image shows an older package as an example. In the current archive, always choose the folder for the Vectorworks version you actually have installed.

You can now start Vectorworks.


Installing the SketchUp extension#

In addition to the Production Assist desktop app, you need the SketchUp extension. Install the extension separately from the SketchUp download package; it does not appear in the desktop app's plug-in installation dialog. The component library is downloaded separately and can then also be opened as a local collection.

  1. Download the Production Assist desktop app and the SketchUp package from the Download page.
  2. Install and start the desktop app at least once.
  3. Extract the SketchUp package. It contains the extension without the component library.
  4. Open SketchUp and select Extensions → Extension Manager → Install Extension.
  5. Select the ProductionAssist.rbz file in the folder for your SketchUp version. The folders and supported versions may vary between download packages, so check the compatibility information for the current package.
  6. Restart SketchUp if it was open during installation.
  7. Open Symbol Library in the Production Assist toolbar and click Install Library at the top of the dialog. The button is available even when no library folder is selected. Choose a permanent destination folder and confirm the download. An internet connection is required; library files with the same name are replaced. Production Assist downloads the latest library for the app version and release channel in use. The library's build number does not have to match the app's build number.
  8. Optional: In SketchUp, open Window → Components, click the house icon, and select Open or Create a Local Collection. Select the same library folder.

The extension adds a Production Assist toolbar and palette to SketchUp. For more information about synchronization, components, and creating your first model, see the SketchUp extension guide.


Installing the AutoCAD and BricsCAD plug-ins#

First install the Production Assist desktop app and start it at least once. An internet connection is required to install through the app. Close AutoCAD or BricsCAD during installation.

Install through the Production Assist app#

  1. In the desktop app, select Help → Install AutoCAD Plugin... or Help → Install BricsCAD Plugin....
  2. In the dialog, select the version that matches your installed CAD version. Host applications that are not detected cannot be selected. The dialog offers only the versions listed there; also check whether the current download package includes a module for your operating system.
  3. Click OK and wait for Installation successful. If Installation failed appears, check your internet connection and the selected version, then try again.
  4. Load the installed module in the CAD application and configure it to start automatically:
    • AutoCAD on Windows: Open APPLOAD, select ProductionAssist.arx in the ARXYY folder for your AutoCAD version, and load the module. Also add it to the Startup Suite. If the Ribbon tab is missing, you may also need to load the included productionassist.cuix.
    • AutoCAD on macOS: For supported versions, the package includes a ProductionAssist.bundle. The loading and Ribbon procedure is not verified in this guide; do not apply the Windows steps unchanged.
    • BricsCAD: Open APPLOAD, select the appropriate BRX or MRX module in the BRXYY folder, and enable Autoload.
  5. Check that the Production Assist tab is available. In the Library panel, click Install Library, choose a destination folder, and confirm the separate download of the DWG library. An internet connection is required. In BricsCAD, then add this folder as a library. BricsCAD, AutoCAD, and ZWCAD use the same DWG library. Current plug-in archives no longer contain the library files.

Manual installation for AutoCAD on Windows#

Use manual installation if your AutoCAD version is missing from the dialog or you want to provide the plug-in yourself. First install the Production Assist desktop app. Close AutoCAD before extracting or replacing the plug-in files.

  1. Download the AutoCAD plug-in package from the Download page and extract the ZIP archive completely to a local folder.
  2. Open the ARXYY folder for your installed AutoCAD major version. Check in the archive that your version and operating system are supported.
  3. Keep ProductionAssist.arx together with all DLLs, libraries, and support files in the extracted folder structure. Do not move only the ARX file. Put the folder in a local location your user account can access; network drives and synchronized cloud folders can slow down or prevent loading.
  4. Start AutoCAD and enter APPLOAD in the command line.
  5. Browse to the ARXYY folder, select ProductionAssist.arx, and click Load. If AutoCAD asks for approval, allow the plug-in permanently. Add the folder to the trusted locations if needed.
  6. In the APPLOAD dialog, add ProductionAssist.arx to the Startup Suite so AutoCAD loads the plug-in again the next time it starts.
  7. Check the Production Assist startup message in the AutoCAD command line. If the Production Assist tab is missing, also load productionassist.cuix on Windows using the AutoCAD CUI command; instructions are in the AutoCAD and BricsCAD installation quick start.

Then install the DWG library using Install Library on the Production Assist tab. The installation downloads the latest library for the app version and release channel in use; its build number does not have to match the app's build number. Production Assist checks the files. For more information about choosing a folder and replacing existing files, see the installation quick start.

These manual steps are documented for AutoCAD on Windows. For supported macOS versions, the package includes ProductionAssist.bundle; loading and Ribbon setup on macOS are not verified here. Do not use the Windows steps unchanged on macOS. For a manual installation, check yourself whether a new plug-in package is available, and replace the complete plug-in folder when updating.

The AutoCAD and BricsCAD versions currently offered in the dialog, as well as manual installation for both CAD applications, are described in the AutoCAD and BricsCAD installation quick start. For the portable desktop app, you must also configure the plug-in AppData directory.

Configure the plug-in AppData directory#

The native Production Assist plug-ins for Vectorworks, AutoCAD, BricsCAD, and ZWCAD, as well as SDK integrations, store settings, login data, resources, and the production_assist_config.json file created by the desktop app in the following directory by default:

Operating systemDefault plug-in directory
Windows%APPDATA%\productionassist
macOS~/Library/Application Support/productionassist

On Windows and macOS, you can specify a different AppData directory for each of these plug-in modules. This is especially useful for the portable desktop app, separate work environments, or multiple independently configured plug-in installations. This configuration does not apply to the SketchUp and grandMA3 plug-ins.

Create the configuration file#

Create a UTF-8-encoded JSON file named exactly productionassist-plugin.json next to the loaded plug-in module or plug-in bundle, depending on the plug-in type. The plug-in reads the file when it starts.

Typical locations are:

  • Windows: in the same folder as ProductionAssist.vlb, ProductionAssist.arx, libProductionAssistBRXYY.brx, or ProductionAssistZRX.zrx.
  • macOS with individual modules: in the same folder as, for example, libProductionAssistBRXYY.mrx.
  • macOS with plug-in bundles: in the same folder as the bundle. For example, place productionassist-plugin.json next to ProductionAssist.vwlibrary or ProductionAssist.bundle, not inside the bundle under Contents/MacOS.

Note for macOS: Because the configuration file is outside the plug-in bundle, you can add or change it without modifying the bundle's code signature. For compatibility, the previous location under Contents/MacOS is still used if there is no configuration file next to the bundle.

Currently, you can define exactly the following override:

KeyTypeEffect
appDataFolderStringSets this plug-in's AppData directory. Relative paths are resolved below the operating system's general AppData directory; absolute paths are used unchanged.

Other keys are ignored. The configuration file affects only the plug-in's product-specific AppData directory. It does not change the operating system's general AppData root directory or the desktop app's Downloads, program, or home directory.

Relative paths#

A relative path creates a separate directory within the general AppData directory:

{
  "appDataFolder": "productionassist-vectorworks-2026"
}

The example resolves to:

  • Windows: %APPDATA%\productionassist-vectorworks-2026
  • macOS: ~/Library/Application Support/productionassist-vectorworks-2026

Absolute paths#

On Windows, absolute paths with drive letters and UNC network paths are supported. Forward slashes avoid the need to escape backslashes in JSON:

{
  "appDataFolder": "D:/ProductionAssist/Daten"
}
{
  "appDataFolder": "//Dateiserver/ProductionAssist/Daten"
}

On macOS, an absolute path begins with /:

{
  "appDataFolder": "/Volumes/ProductionAssist/Daten"
}

To use a plug-in with the portable Windows app, enter the full path to its data folder:

{
  "appDataFolder": "D:/Programme/ProductionAssist/ProductionAssist-data"
}

First start the portable desktop app at least once, then close the desktop app and CAD application. Place the configuration file next to each plug-in module you use. After the next start, the plug-in uses the production_assist_config.json file from this folder, among other data.

Behavior for missing or invalid values#

The plug-in uses its default directory if:

  • productionassist-plugin.json is missing or is not a valid JSON object,
  • appDataFolder is missing or is not a string,
  • appDataFolder is empty or contains only spaces.

Environment variables such as %APPDATA% and shortcuts such as ~ are not resolved in the value. Use either a relative path or a fully absolute path. The target directory must be writable by the signed-in user. When changing the directory, existing data is not moved automatically. If necessary, copy it manually to the new directory while the desktop app is closed and the CAD application is not running.

Uninstall the Vectorworks plug-in#

We're sorry that you want to leave us. If you have encountered any problems, you can always contact us here.

macOS#

If you installed the plug-in manually, delete ProductionAssist.vwlibrary from the Plug-ins folder for your Vectorworks version under ~/Library/Application Support/Vectorworks. If you installed it through the desktop app, remove the ProductionAssist link there instead.

Windows#

If you installed the plug-in manually, open the Plug-ins folder where you copied it and delete these Production Assist files:

  • the ProductionAssistWeb folder
  • ProductionAssist.vlb
  • ProductionAssist.vwr

If you installed it through the desktop app, remove the ProductionAssist.lnk shortcut instead from the Plug-ins folder for your Vectorworks version under %APPDATA%\Nemetschek\Vectorworks\<Year>.