Skip to main content
this document is for:

Deployment: Invicti Platform on-premises

Part of Windows on-premises installation series

This is part 4 of 4 in the Windows on-premises installation series.
Previous: Trustlist configuration

Update or uninstall

Invicti Platform on Windows on-premises supports two update paths:

  • Standard update - initiated from the Invicti Platform Control Center. The Control Center downloads the latest Helm chart and performs a Helm upgrade within the existing WSL2 environment. This is the recommended path for routine updates.
  • Hard update - a full uninstall and reinstall. Use this when the standard update fails. Your data is preserved across a hard update.

This document explains both paths, and covers uninstallation.

Why this matters​

Keeping Invicti Platform up to date ensures you have the latest security checks, vulnerability detections, and platform features. Updates are delivered as new installer and WSL2 distribution packages, and can be applied through the Control Center or via a hard update when the standard update fails.

Standard update​

The standard update runs a Helm upgrade inside the existing WSL2 environment. Your data, configuration, and WSL2 setup aren't affected.

  1. Open the Invicti Platform Control Center at http://localhost:8088/.

  2. Select Maintenance from the left navigation.

  3. In the Updates section, click Re-check to confirm the latest available version is shown.

  4. Click Update now. The Control Center automatically starts downloading the latest Helm chart and applies it.

  5. Monitor the update log in the Update log details panel. A successful update ends without errors.

Invicti Platform Control Center Maintenance page showing the Updates section with Update now and Re-check buttonsInvicti Platform Control Center Maintenance page showing the Updates section with Update now and Re-check buttons
note

If the update fails with the message "ERROR: Helm upgrade command failed. Check service logs for details.", use the hard update path instead.

Hard update​

A hard update uninstalls the platform and reinstalls it from scratch. Your scan data and configuration stored in the VHDX file are preserved - only the application layer is replaced.

Configuration is not preserved

The VHDX data file is preserved, but your installation configuration is not. Have the following ready before starting the hard update:

  • License key
  • SMTP details (if configured)
  • TLS certificate and private key (if configured)
  • External database connection details (if using an external PostgreSQL database)
  • Hostname / platform address

Before you start​

Download the files you need and place them in the same directory (for example, C:\InvictiSetup\):

FileDescription
Installer executableLatest installer for Windows
WSL2 distribution tarballLatest WSL tarball to upgrade the full platform, or previous WSL tarball if you only want to update the platform and keep the existing WSL2 and Helm versions unchanged

To obtain these files, please contact your Invicti sales representative.

Upgrading WSL and Helm

If you provide the same WSL tarball version that's currently installed, the installer detects the version match and skips the WSL2 and Helm upgrade. Only the platform layer is updated.

Steps​

  1. Right-click C:\Program Files\Invicti\Platform\Uninstall.exe and select Run as administrator. Wait for the uninstaller to complete.

    The uninstaller removes the application but preserves the VHDX data file.

  2. Right-click the new installer .exe and select Run as administrator.

  3. Follow the installer prompts. When asked for the WSL2 distribution file, provide the path to the WSL tarball you downloaded.

  4. Re-enter your configuration when prompted:

    • Email address and license key
    • SMTP settings (if used)
    • TLS certificate (if used)
    • External database details (if used)
    • Hostname / platform address

  5. Wait for the installation to complete. The installer redeploys the platform on top of the existing VHDX data.

  6. Verify the platform is running. For more information, refer to the post-installation verification section in the Installation document.

Uninstall​

To uninstall Invicti Platform, right-click C:\Program Files\Invicti\Platform\Uninstall.exe and select Run as administrator.

The uninstaller removes the application, WSL2 distribution, and service, but preserves the VHDX data file at C:\Program Files\Invicti\Platform\data\. If you want a fully clean removal, delete this folder manually after uninstalling.

Next steps​

With your deployment updated or uninstalled, refer to the installation guides for redeployment:

→ Return to Prerequisites

Complete Windows installation series​

Need help?​

Invicti Support team is ready to provide you with technical help. Go to Help Center

Last updated on
Was this page useful?