Jump to content
  • Command Line Installation of Vectorworks 2026


    Tim Ardoin

    NOTE: This article is intended for IT professionals with an understanding of the command line/terminal interface. 
     

    Legacy (VWIM Command Line):

     

    This article is not intended for all users and is not a required procedure for installing Vectorworks in a standard work environment. Do not use these steps unless you are specifically attempting to initiate a silent install of Vectorworks in a network environment or are specifically instructed to do so by Vectorworks Technical Support.

     

    The Vectorworks installer provides a command line interface for driving a silent installation from the command line. We also provide a native .msi package on Windows and .pkg package on MacOS. We suggest and expect you will want to use the native packages, and that is what this document explains. For the Install Manager's command line interface, please reference the Command Line Installation of Vectorworks 2025 document, as the interface is unchanged.

     

    MSI (Windows):

     

    The MSI is available in the Customer Portal downloads section or by choosing "Advanced" from the VWIM triple bar menu. It is provided as a zip file. The zip file contains the msi file itself, .cab files that contain the payload, a productcode.txt file, and finally an "install.bat" file that can simplify and/or serve as a base for your install process.

     

    To install Vectorworks, a few arguments must be passed to the MSI to provide the serial, LDF (License Description File), and Installation Directory. The install.bat file clarifies and checks these options, as well as checking for proper privileges and creating a log file.

     

    The usage of install.bat is:

    install.bat "Vectorworks2026.msi" "C:\Program Files\Vectorworks 2026" "ABCDDE-XXXXXX-XXXXXX-LLLLLL" "c:\mytemp\DD-LLLLLL.ldf" "msiLog.txt"

     

    The parameters are, in order:

    • The path and filename of the .msi file (not the zip).
    • The install directory
    • The serial number
    • An LDF file, previously downloaded
      • This can be an empty string ( "" ) . If so, the MSI will attempt to fetch the LDF file from our servers based on the serial number. If successful, that fetched LDF will be used.
    • A path and filename to a log file, useful to diagnose problems. Please note that this file may contain the serial number as msiexec will log it.

     

    The batch file runs msiexec on the msi, passing the requested parameters. It's possible to use msiexec directly, and the .bat file can be used as a reference for how to do this.

    Also in the batch file are instructions for doing a command-line uninstall.

     

    PKG (MacOS):

     

    On mac, a .pkg file is provided. This is available by clicking "Advanced" from the triple bar menu in the Install Manager. This file requires a configuration .plist file placed next to it, so it can retrieve the serial number, a path to the LDF file, and an optional list of users for which to store serial number information. The plist file must be named vw2026.plist, and must be located next to the .pkg file. Here is a sample plist file:

     

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
        <key>users</key>
        <array>
            <dict>
                <key>username</key>
                <string>user1</string>
                <key>serial</key>
                <string>EMXDDM-XXXXXX-XXXXXX-LLLLLL</string>
            </dict>
        </array>
        <key>serial</key>
        <string>EMXDDM-XXXXXX-XXXXXX-LLLLLL</string>
        <key>ldf</key>
        <string>/tmp/DD-LLLLLL.ldf</string>
    </dict>
    </plist>

     

    The "users" array is optional and will cause the postinstall script in the pkg to create the licensing plists and copy the LDF into a user folder for each entry. The outer "serial" will be copied to the system location /Library/Preferences. Additionally, the outer "serial" and "ldf" keys are used internally to determine which features of Vectorworks to install.

     

    Note that user1, the serial numbers, and the LDF name should be customized to match your items.


    Once the plist file is created, the following command can be used to install the pkg:

    sudo installer -pkg ./Vectorworks2026.pkg -target /Applications

     

    It is currently required that Vectorworks installed via a pkg is installed to /Applications/Vectorworks 2026/.

     

    Note that once installed, MacOS remembers this install. To install a second time (for example if you delete the install folder), you must first tell macOS to forget it as follows:
     

    sudo pkgutil --forget net.nemetschek.vectorworks.installer

     

     



      Report Article



    User Feedback


    Wow! Thanks for embracing MSI! 🙂
    I know it has been an option for a while now, but VWIM worked better for us.
    I'll do my deployment testing tomorrow. Fingers crossed. 🙂

    • Like 1
    Link to comment

    So, a quick update / feedback:
    - I had to add ALLUSERS=1 to the command line in order to get it to reliably add the shortcut to the start menu and register in control panel/programs&features

    - How are we supposed to install the Viewer?
    The install.bat says "The viewer batch doesn't take serial or ldfFile", but there is no "viewer batch", and setting SERIAL="VIEWER" (because VWIM install works with that) or leaving it empty (tried both with no serial param and SERIAL=""), doesn't work.

    Link to comment
    • Vectorworks, Inc Employee

    Hi @RMPSL,

    Thanks for the feedback and the tip about ALLUSERS. I'll look into that and amend the above post with it when I understand better how it affects things.

     

    Can you clarify what you mean by "VWIM worked better for us"? Do you mean better than MSI, or better in general than for some other customers? Or do you mean it worked better than the (somewhat experimental/non-officially supported) MSI that Computerworks had for awhile?

     

    Regarding the viewer - there is a separate MSI for this. Because of how MSI works and because a common use case is to have both the Viewer and the Full install installed in parallel, a separate Viewer MSI was required. I'll do some work to see if I can figure out what state that is and where to get it. Unfortunately the current state of being able to download these is a little bit in flux currently. More soon.

    • Like 1
    Link to comment

    VWIM worked better for us than the MSI, when I tried it last time.
    Now it's the other way around, MSI makes our deployment much simpler.

    Viewer: thank's for the info!

    Link to comment

    @Tim Ardoin Will the macOS PKG also be available for German users? Or is this only available in English? Comuterworks told me that the only way to install 2026 in silent mode is the cli way. They don't know anything about an PKG installer. 

    Link to comment


    Join the conversation

    You can post now and register later. If you have an account, sign in now to post with your account.
    Note: Your post will require moderator approval before it will be visible.

    Guest
    Add a comment...

    ×   Pasted as rich text.   Restore formatting

      Only 75 emoji are allowed.

    ×   Your link has been automatically embedded.   Display as a link instead

    ×   Your previous content has been restored.   Clear editor

    ×   You cannot paste images directly. Upload or insert images from URL.


×
×
  • Create New...