Jump to content
  • Command Line Installation of Vectorworks 2025


    Tim Ardoin

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

    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.

     

    Windows:

    • We will use a temporary folder at C:\tmp (as an example) to store the necessary files.
    • We recommend using 7-zip for Windows to extract the necessary files.
    • If your installation is also offline, you will need an LDF file from the Customer Portal. Copy this file to C:\tmp.
    • Download a copy of the Windows Vectorworks Install Manager from the Customer Portal into C:\tmp.
      • This is an exe file, but it's a self-extracting archive and can be treated as a .zip file.
      • This exe will be named something like "Vectorworks 2025 Install Manager XXXXXX.exe".
    • Right click the exe file and choose 7-Zip-> Extract to <name>, and extract the archive to a folder.
      • This will create a folder such as Vectorworks 2025 Install Manager 776367.
      • Rename this folder to "VWIM" to follow the rest of this example.
    • Start an administrator command prompt and type the following commands depending on what you want to do:
    • cd c:\tmp\VWIM\resources
      • This puts you in the resources folder where the command line scripts are found.
    • To get information about the available commands:
      • cli.bat
    • To get information about a specific command:
      • cli.bat <command> --help
      • Specific example:
        • cli.bat download --help
    • To see the list of potential updates/targets:
      • cli.bat download --ls
    • To download a .vwupdate file:
      • cli.bat download --dest c:\tmp --target <target>
      • Specific example:
        • cli.bat download --dest c:\tmp --target Update0
        • This will download a file Update0.vwim into c:\tmp that can later be used to do an offline update or full install.
      • Note that alternately you can use the Install Manager GUI to easily download a .vwim file.
    • To perform an install from online sources:
      • cli.bat install --installdir "C:\Program Files\Vectorworks 2025" --serial "ELXXXX-XXXXXX-XXXXXX-XXXXXX"
    • To perform an install from offline (local) sources:
      • cli.bat install --installdir "C:\Program Files\Vectorworks 2025" --serial "ELXXXX-XXXXXX-XXXXXX-XXXXXX" -i "C:\tmp\Update0.vwim" --ldf C:\tmp\XX-XXXXXX.ldf
        • This uses the previously downloaded vwim file Update0.vwim.
        • This uses the previously download ldf file XX-XXXXXX.ldf (from the Customer Portal).
    • To install the viewer:
      • Use "VIEWER" as your serial number
      • Don't supply an LDF.
      • cli.bat install --installdir "C:\Program Files\Vectorworks 2025 Viewer" --serial "VIEWER"

     

     

    MacOS:

    • For this example we will use the folder /tmp/vwim. You can create and change to this folder by opening a terminal and typing:
      • cd /tmp && mkdir vwim && cd vwim
    • Download the latest Mac Vectorworks Install Manager.zip from the Customer Portal.
      • This will be named similar to: Vectorworks 2025 Install Manager-30.0.776374-mac.zip
      • For this example, we will rename this zip file to vwim.zip and copy it to /tmp/vwim.
    • If you're performing an offline installation:
      • Download a LDF file from the Customer Portal.
        • Copy this into /tmp/vwim, for example /tmp/vwim/XX-XXXXXX.ldf
    • Extract the VWIM.zip:
      • unzip vwim.zip
      • This creates "Vectorworks 2025 Install Manager.app" inside /tmp/vwim.
    • Enter the resources folder (a simplification for this example)
      • cd "Vectorworks 2025 Install Manager.app/Contents/Resources"
    • On MacOS, we will use the "sudo" command to gain administrator access. Because of how sudo and users work, we need to gather information about the user account that will be the owner/main user of Vectorworks. Specifically we need the uid (user ID) and gid (group ID) of the user.
      • In this example we will use commands to put the user and group ids into variables and also print them out.
      • export myUid=$(id -u) && echo "User $USER id: $myUid stored in variable myUid"
      • export myGid=$(id -g) && echo "User $USER gid: $myGid stored in variable myGid"
      • Now we have the variables $myUid and $myGid ready to use in subsequent commands below.
    • We are now ready to issue commands to the command line interface.
    • To get information about the available commands:
      • ./cli.sh
    • To get information about a specific command:
      • ./cli.sh <command> --help
      • Specific example:
        • ./cli.sh download --help
    • To see the list of potential updates/targets:
      • ./cli.sh download --ls
    • To download a .vwupdate file:
      • ./cli.sh download --dest <path> --target <target>
      • Specific example:
        • ./cli.sh download --dest /tmp/vwim --target Update0
        • This will download a file Update0.vwim into /tmp that can later be used to do an offline update or full install.
      • Note that alternately you can use the Install Manager GUI to easily download a .vwim file.
    • To perform an install from online sources:
      • sudo ./cli.sh install --installdir "/Applications/Vectorworks 2025" --serial "ELXXXX-XXXXXX-XXXXXX-XXXXXX" --uid $myUid --gid $myGid
        • Note we're using the uid and gid variables we stored earlier in this guide.
        • This will install Vectorworks and give ownership and access to the specified user.
        • The source files and ldf file will be retrieved online automatically during installation.
    • To perform an install from offline (local) sources:
      • sudo ./cli.sh install --installdir "/Applications/Vectorworks 2025" --serial "ELXXXX-XXXXXX-XXXXXX-XXXXXX" -i "/tmp/vwim/Update0.vwim" --ldf /tmp/vwim/XX-XXXXXX.ldf --uid $myUid --gid $myGid
        • This uses the previously downloaded vwim file Update0.vwim.
        • This uses the previously download ldf file XX-XXXXXX.ldf (from the Customer Portal).
    • To install the viewer:
      • Use "VIEWER" as your serial number
      • Don't supply an LDF.
      • sudo ./cli.sh install --installdir "/Applications/Vectorworks 2025 Viewer" --serial "VIEWER" --uid $myUid --gid $myGid

     

     

    • Like 5
    • Sad 1
    • Love 1


      Report Article



    User Feedback




    On 11/5/2024 at 9:55 PM, Tim Ardoin said:

    @RMPSL 

    I'll think about this speed difference. I doubt MSI packages unpack much faster than a zip, but there could be overhead for .vwim in general we could optimize out.

     

    I do have a question though. Our current thinking is that MSI puts you on the "MSI" path where to update you just install the new MSI, rather than a hybrid of installing with MSI and then using the updater. Do you think that's ok? Internally MSI works very differently from how the VWIM/Updater work as far as tracking installed files so I worry about some cases like uninstall after an update. That's why there's no updater (VWIM now) after installing from MSI.

     

     

    One thing I noticed re speed difference is the size difference between MSI and VWIM offline source: MSI is about 8GB, while VWIM size is nearly double.

    And yes, with Vectorworks updating with MSI means always uninstalling and doing a full reinstall with the new version, which is a deal breaker for MSI in our case.
    But it doesn't have to be this way, MSI is able to apply differential updates via .MSP packages (Adobe Reader does this, it's official MSI is from 2015 (!) and we just push the latest MSP right after deploying the MSI), maybe you could see if you are able to provide those?

    In further testing I also ran into some issue with the G-series install via MSI: I did get the prompt to provide an LDF, and of course I did that, but it just kept asking - even after copying it to the install directory manually.

    We'll stick to the VWIM CLI for now. 🙂

    • Like 1
    Link to comment
    8 hours ago, knijgh said:

    Hi all,

     

    I have installed 2 variants here using the cli method cli.bat install --installdir "C:\Program Files\Vectorworks 2025" --serial "ELXXXX-XXXXXX-XXXXXX-XXXXXX" 1 variant in English, and this works well, at first it did not want to start but it turned out that the Site Protection Server also had to be updated, the other variant in Dutch, a license code had to be entered when starting up, this was apparently not included with the above method. I also saw that it did not appear in the control panel/programs so manual uninstallation is not possible. Is it also possible not to place a shortcut of the installation folder on the desktop, but a shortcut to Vectorwork.exe. Now I can do this with powershell but it would be more convenient if this happened immediately.

     

    Thanks in advance

    Sounds like your VWIM isn't up to date. It should self-update now (bug preventing that was fixed), but to be sure I'd recommend doing it manually:
    cli.bat download-latest-updater c:\vwim -p w

    This should at least fix the missing programs&features entry and shortcut.
     

    Edited by RMPSL
    Link to comment
    16 hours ago, RMPSL said:

    Sounds like your VWIM isn't up to date. It should self-update now (bug preventing that was fixed), but to be sure I'd recommend doing it manually:
    cli.bat download-latest-updater c:\vwim -p w

    This should at least fix the missing programs&features entry and shortcut.
     

     

    thanks for your response
    i ran the command you suggested, then ran the installer manually, so there was a version difference in the VWIM, after installing it indicated that everything was up to date, when I click on the three lines at the top right and choose download, only update 1 is listed as the latest update, so I expect the Dutch version to be behind the English version.

    Link to comment
    On 11/8/2024 at 12:27 PM, knijgh said:

     

    thanks for your response
    i ran the command you suggested, then ran the installer manually, so there was a version difference in the VWIM, after installing it indicated that everything was up to date, when I click on the three lines at the top right and choose download, only update 1 is listed as the latest update, so I expect the Dutch version to be behind the English version.

    It's the VWIM that needed updating in order for the CLI installer to work properly. Using the new VWIM CLI you should now get the entry in programs&features and the desktop shortcut.

    Link to comment
    On 10/29/2024 at 11:43 PM, Tim Ardoin said:

    So to summarize:

    • Self-updating for CW is broken but will be fixed tomorrow morning (nice find on the vwim/vwim thing).
    • Once self-update works, a new VWIM (either from self-update or downloading again) will:
      • Not yet have the CLI uninstall option
        • Will be present in Update 2. Talk to me if this is unacceptable.
      • Will fix Windows lack of programs & features entry

    I can confirm that everything is working now. 
    Thank you very much, Tim!

    Link to comment
    Quote

    Download a copy of the Windows Vectorworks Install Manager from the Customer Portal into C:\tmp.

    This is an exe file, but it's a self-extracting archive and can be treated as a .zip file.

    This exe will be named something like "Vectorworks 2025 Install Manager XXXXXX.exe".

    Right click the exe file and choose 7-Zip-> Extract to <name>, and extract the archive to a folder.

    This will create a folder such as Vectorworks 2025 Install Manager 776367.

    Rename this folder to "VWIM" to follow the rest of this example.

    Start an administrator command prompt and type the following commands depending on what you want to do:

    cd c:\tmp\VWIM\resources

    This puts you in the resources folder where the command line scripts are found.


    This isn't correct anymore.
    Extracting the downloaded EXE will give you a "$PLUGINSDIR" folder.
    Inside that folder you will find a file named app64.7z
    Extracting that file will give you the actual VWIM files & folders.

    Link to comment

    I am using the 30.3.791806 VWIM on macOS Sequoia. While I had experienced success with earlier versions of VWIM downloading the content on the fly and installing, I am having a nearly 95% failure rate with this version. It appears to be timing out and/or failing on validation of the payload.

     

    To be clear, what I have done is taken the latest version of VWIM, placed it in a standard macOS Installer package (.pkg), and used a postinstall script referencing it to do the install. The postinstall script looks like this:
     

    vers="2025"
    vwipathroot="$(dirname $0)"   # points to the location within the pkg where VWIM is located
    # Install Vectorworks by downloading on the fly
    "${vwipathroot}/Vectorworks ${vers} Install Manager.app/Contents/Resources/cli.sh" install --installdir "/Applications/Vectorworks ${vers}" --serial G-redacted-P --uid 0 --gid 80

     

    This allows me to push out the install with my MDM (Jamf Pro). As I said, this was working with an earlier version of VW 2025 being installed on macOS Sonoma. I build this package in an automated fashion using AutoPkg so that I can rebuild it easily for each new release. This is also why I haven't attempted to pre-download the content, as I will always have to do manual work for each release for that to happen, so downloading on the fly seemed better since I have very good network throughput.

     

    Any clues on why this might be happening or where I might look (specific logs?) to suss this out further?

    Link to comment

    Anthony, Tim,

     

    I've done something similar to the above. pushed this out via Addigy MDM and this is the error message I got:

     

    BaseError: Could not get admin privileges
        at ./Vectorworks 2025 Install Manager.app/Contents/Resources/cli.js:18036:33
        at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {
      type: 'elevateError',
      keyList: []
    }

    Node.js v18.15.0

     

    I think all MDM executes via root. I've done chmod -R 777 to the installer folder and still got the same results. 

     

    Kevin

    • Like 1
    Link to comment

    Is there a way to do an offline silent installation of the viewer?

     

    This command will download the files from the internet

    • cli.bat install --installdir "C:\Program Files\Vectorworks 2025 Viewer" --serial "VIEWER

     

    For the full version you can use the Update0.vwim to do an offline installation, but for the Viewer, it is not possible to download a ".vwim"-File.

    I also didn´t find a possibility to download it via the Install Manager GUI.

     

    Would be nice to have a possibility to download something like a Viewer.vwim and use it for an offline silent installation of the Viewer.

    Using it like that: cli.bat install --installdir "C:\Program Files\Vectorworks 2025 Viewer" --serial "VIEWER -i "/tmp/vwim/Viewer.vwim"

     

    image.png.a38282685d534b45e7504bd646882465.png

    • Like 1
    Link to comment
    On 1/5/2025 at 9:30 PM, KevinTK said:

    Anthony, Tim,

     

    I've done something similar to the above. pushed this out via Addigy MDM and this is the error message I got:

     

    BaseError: Could not get admin privileges
        at ./Vectorworks 2025 Install Manager.app/Contents/Resources/cli.js:18036:33
        at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {
      type: 'elevateError',
      keyList: []
    }

    Node.js v18.15.0

     

    I think all MDM executes via root. I've done chmod -R 777 to the installer folder and still got the same results. 

     

    Kevin

     

    Seeing this error via Jamf Pro as well. 

    • Like 1
    Link to comment

    Hi,

     

    why does the vwim file contain both Mac and Windows installation files? I only need Windows installation files but I have to download 15GB and then delete the Mac stuff inside the .vwim before I upload it to my distribution servers... otherwise I would waste nearly 8GB of disk space on each of my ~20 distribution servers...

    I think with VWX 24 you could choose what platform to download for...

     

    Thx,

    Jörn

    • Like 2
    Link to comment
    Quote

    why does the vwim file contain both Mac and Windows installation files?

     

    Having platform-specific downloads would be helpful on the Mac side as well. We tried to create an installer package with the vwim and it failed unless we added a special --large-payload option (necessary if the payload is > 8 GiB)/

    • Like 2
    Link to comment
    On 1/23/2025 at 11:02 AM, Jörn NM said:

    I think with VWX 24 you could choose what platform to download for...

     

    Yes. And this explains why the VWIM download is double the size of the MSI.

    Link to comment

    "Fun" fact: until U3 I was not able to cli.bat uninstall with the VWIM in my "install work" directory c:\VWIM.
    I had to use the VWIM installed in C:\Program Files\Vectorworks 2025\Vectorworks 2025 Install Manager
    With U3 it's vice versa: the VWIM in C:\Program Files\Vectorworks 2025\Vectorworks 2025 Install Manager only shows "Preparing for uninstall" (translated from German), the VWIM in c:\VWIM is able to uninstall via cli.bat

    Link to comment

    VW 2024 silent installation command used to work for us without specifying --LDF. For example, below command works fine for us in VW 2024.

     

    "%~dp0resources\installer\Install Vectorworks2024.exe" --mode unattended --unattendedmodeui none --Serial G?????-??????-??????-?????? --installdir "C:\Program Files\Vectorworks 2024" --LDFChoice licenseID

     

     

    For VW 2025, unusre if I read correclty about license key start with G does not require command to specify LDF file. 🤔

     

    Our key starts with G but when I omit the --LDF parameter, it asked to specify one. 🥹

     

    Below won't install
    cli.bat install --installdir "C:\Program Files\Vectorworks 2025" --serial "G?????-??????-??????-??????" -i "C:\temp\vw2025\Update3.1.vwim" 

     

    Below will install

    cli.bat install --installdir "C:\Program Files\Vectorworks 2025" --serial "G?????-??????-??????-??????" -i "C:\temp\vw2025\Update3.1.vwim" --ldf "C:\temp\vw2025\??-??????.ldf"

     

    Sorry if this another dupe question -- May I also ask if there is parameter for VW 2025 CLI silent install, please?

     

    Thanks everyone

     

     

    Link to comment

    LDF seems to be downloaded automatically during install if there is internet access and no --ldf is provided.
    We install our G-Series with this command:
    c:\vwim\resources\cli.bat install --installdir "C:\Program Files\Vectorworks 2025" --serial "GXXXX-XXXXXX-XXXXXX-XXXXXX" -i "C:\vwim\install.vwim"

    Link to comment
    On 2/8/2025 at 4:38 AM, RMPSL said:

    LDF seems to be downloaded automatically during install if there is internet access ......

     

    Thanks

     

    Let us say computer does have internet access but there are cyber and web security products on laptop potentially blocking certain traffic or file download.

     

    To request our IT allowing the automatic LDF file download, what are the URLs to be allowed, please?

     

    I can download from customer protal fine, just not 100% sure on source URLs of LDF that CLI.BAT downloads from.

     

    Thanks again.

    Link to comment

    Does anyone know of a way to install it silently without inputting a serial or providing an LDF?

    I need to deploy this to about 50 people so getting them to put in their serial and/or provide an LDF isn't really an option

    • Like 1
    Link to comment
    14 hours ago, Sean Charters said:

    Does anyone know of a way to install it silently without inputting a serial or providing an LDF?

    I need to deploy this to about 50 people[…]

     

    Are you deploying to Mac, Windows, or both? Those of us who run macOS in University labs have been struggling with a mass-deployable solution for months, sharing ideas and strategies in the Mac Admins Slack. We do have solutions that work some of the time, but updating or reinstalling has been a real issue. Passing the serial using the command line installer is the method that worked previously, but 2025 seems to be a rewrite of the mechanism.

    Edited by Anthony Reimer
    Link to comment

    trying to reply with something that worked for me, but kept getting "forbidden 403". i also can't attach anything.

    Link to comment
    On 3/28/2025 at 8:29 AM, Sean Charters said:

    Does anyone know of a way to install it silently without inputting a serial or providing an LDF?

    I need to deploy this to about 50 people so getting them to put in their serial and/or provide an LDF isn't really an option

     

    There is no way to install this silently without the license or serial! (LDF is used during offline install), do this in Install.bat

     

    @echo off

     

    REM Get the full path to the current directory

    set "baseDir=%~dp0"

     

    REM Loop through any 7z* folders in the current directory

    for /d %%F in ("%baseDir%7z*") do (

        if exist "%%F\resources\cli.bat" (

            "%%F\resources\cli.bat" install --installdir "C:\Program Files\Vectorworks 2025" --serial "XXXXXX-XXXXXX-XXXXXX-XXXXXX" -i "%baseDir%Update\Update5.vwim"

        )

    )

     
    Enter in a temp lic key for the first one by replacing XXXXXX-XXXXXX-XXXXXX-XXXXX in the install.bat, once you install this on your Test-VM it will create %APPDATA%\Nemetschek\Vectorworks\2025\XX-XXXXXX.ldf" you hang onto this and for the other 49 users copy this to their APPDATA DIR during install with the key then del after finish installing. The user is then prompted to signin using their creds!
     
    Edited by DCS_Jarrad
    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...