Upgrade Guide

Before you upgrade

Before installing a new version:

• Export important sessions to .ptpx
• Read the latest release notes
• Check whether the release changes licensing, Team Mode, or package formats

Upgrading from v1.x to v2.0.0

One-time manual migration

PentestPath v2.0.0 is a complete rewrite of the desktop runtime (Electron → Tauri v2 + Rust). The in-app auto-updater is intentionally disabled for the v1.x → v2.0.0 transition to prevent silent loss of session data and license state. If you are running v1.4.0 or earlier, follow the steps on this page before installing v2.0.0.

Auto-update resumes normally for v2.0.0 → v2.x.x and never requires this procedure again.

Step 1 — Export your sessions from v1.x

In your existing v1.x install, open every session you want to keep and export it as a .ptpx package:

1. Open the session.
2. Go to Settings → Export → Full session export.
3. Save the .ptpx file somewhere outside the PentestPath install directory (your home folder is fine).

Repeat for every session that holds work you want to keep.

Step 2 — Save your license key

Open Settings → License in v1.x and copy your license key into a password manager or any location where you will be able to find it again. You will need it to re-activate v2.0.0.

Step 3 — Uninstall v1.x

Use your operating system's normal uninstaller:

• Windows: Settings → Apps → Installed apps → PentestPath → Uninstall
• Linux (.deb): sudo apt remove pentestpath
• Linux (AppImage): delete the AppImage file

Step 4 — Install v2.0.0

Download the v2.0.0 installer from the v2.0.0 release page and run it. The installer creates a fresh native install with no leftover Electron runtime.

Step 5 — Restore your data and license

1. Launch PentestPath v2.0.0.
2. Open Settings → Import and import each .ptpx package you exported in step 1.
3. Open Settings → License, paste your license key from step 2, and activate.

Your sessions, findings, evidence, and reports are now available in the new native app.

TIP

After this one-time migration, future updates (v2.0.0 → v2.0.1, v2.1.0, etc.) install automatically through the in-app updater with no manual intervention.

Updating between v2.x releases

For any v2.x → v2.y update:

1. Download the new release package.
2. Close PentestPath completely.
3. Install the new version over the existing one, or replace the AppImage you use.
4. Launch the app and confirm your sessions and settings are present.

The in-app auto-updater can also handle this for you in the background.

What normally stays in place between v2.x releases

• Session list
• License state
• Theme and language preferences
• Shortcut bindings

When to export first

Export your current sessions before upgrading if you are:

• testing a beta build
• moving to another machine
• changing operating system
• troubleshooting vault or license issues
• upgrading from v1.x to v2.0.0 (mandatory — see the section above)

After the upgrade

• Read Release Notes
• Revalidate Team Mode if you use a self-hosted relay
• Review Common Errors if something behaves differently