FAQ

Can I work on multiple packages at the same time? #

Yes. Create as many packages as you need from the dashboard (free edition limit: 10). Switch between them by clicking a card or using the package picker. Each package has its own files, configuration, phases, and test-run settings.

Do I need an internet connection? #

Only for:

• Downloading .NET 9 runtimes (first install only, if not already installed)
• Downloading the latest PSADT from GitHub (optional)
• Checking for toolkit updates (optional; toggle in Settings)

All other functionality works completely offline.

Where are my packages saved? #

Package definitions (configuration, phase code, parameters) are saved in %AppData%\XOAP\PackageWizard\packages.json. Uploaded files are in %AppData%\XOAP\PackageWizard\workspace\Files\{packageId}\.

Can I back up my work? #

Yes. Copy the entire %AppData%\XOAP\PackageWizard\ folder. It contains all your packages, preferences, uploaded files, and downloaded toolkits.

How do I use the exported package? #

The exported .zip is a standard PSADT v4 package. Extract it and run:

# Interactive install
.\Invoke-AppDeployToolkit.ps1 -DeploymentType Install

# Silent install
.\Invoke-AppDeployToolkit.ps1 -DeploymentType Install -DeployMode Silent

# Uninstall
.\Invoke-AppDeployToolkit.ps1 -DeploymentType Uninstall

# Repair
.\Invoke-AppDeployToolkit.ps1 -DeploymentType Repair

Or deploy it via SCCM/MECM, Intune, or any tool that executes PowerShell scripts.

Can I import my old PSADT v3 packages? #

Yes. Use Import Local on the dashboard. The wizard detects v3 packages (Deploy-Application.ps1) and translates commands, variables, and parameters to v4 syntax automatically. Commands that map to multiple v4 functions are annotated with # TODO comments for you to resolve.

The application won’t start — what do I check? #

1. Check the logs at %AppData%\XOAP\PackageWizard\logs\
   • desktop-{date}.log — Shows startup errors, API health check results
   • api-{session}.log — Shows API server errors
2. Verify .NET 9 is installed: Open a command prompt and run dotnet --list-runtimes. Look for Microsoft.WindowsDesktop.App 9.0.x and Microsoft.AspNetCore.App 9.0.x.
3. Reinstall if the issue persists — uninstall first, delete the install folder, then reinstall.

How do I update XOAP PSADT Package Wizard? #

Run the new installer. It will upgrade the existing installation in place. Your packages and settings are stored in %AppData% and are not affected by upgrades.

Can I change the install location? #

Yes, during installation you can choose any folder. The default (C:\Program Files\XOAP PSADT Package Wizard) is recommended because the [InstallDelete] step in Inno Setup’s upgrade handling looks for that location.

Is my data sent anywhere? #

No. XOAP PSADT Package Wizard runs entirely on your local machine. The only outbound network requests are:

• Checking GitHub for the latest PSADT version (optional, can be disabled in Settings)
• Downloading PSADT from GitHub (only when you click Download Latest)
• Downloading .NET runtimes from Microsoft (only during first install if needed)

No telemetry, no cloud services, no data leaves your machine.

What do the “Not available in Free version” lock badges mean? #

They mark features that are visible in the UI so you can see the full feature surface, but are not active in the free edition. See EDITIONS.md for the full comparison.

How do I test my script without exporting? #

Go to the Preview step (step 7), pick a DeploymentType and DeployMode, optionally toggle Run as Admin, and click Test Run. The script executes on your local machine and streams output into the embedded terminal. Test Run has a 120-second timeout.