# VaultLine VPN - Release Notes

---

## Version 2.0.0

**Release Date:** June 2, 2026  
**Platform:** Windows 10 / 11 (64-bit)  
**Build:** Production Release

---

### Overview

Version 2.0.0 is a major reliability and compatibility release that resolves critical installer issues discovered in v1.x. This release ensures a smooth, error-free installation experience across all supported Windows configurations.

---

### Bug Fixes

#### Fixed: WireGuard Installation Failures
- **Issue:** The WireGuard MSI installer would fail with "file not found" errors during installation on some systems.
- **Root Cause:** The WireGuard MSI was being referenced before the Inno Setup extraction phase had completed. The installer attempted to execute the MSI from a temporary directory before the file was actually written to disk.
- **Fix:** Added explicit `ExtractTemporaryFile()` call to ensure the WireGuard MSI is fully extracted and available before the silent installation begins. This guarantees the MSI is present regardless of Inno Setup's internal extraction timing.

#### Fixed: Error 740 - Elevation Required on Launch
- **Issue:** After installation, launching VaultLine VPN from the installer's "Launch now" checkbox would fail with Windows Error 740 ("The requested operation requires elevation").
- **Root Cause:** The `[Run]` section used `CreateProcess` (via the `nowait` flag) to launch the application. Because `vaultline_vpn.exe` has a `requireAdministrator` manifest, `CreateProcess` fails - it cannot elevate a child process.
- **Fix:** Added the `shellexec` flag to the post-install run entry. This uses `ShellExecute` instead of `CreateProcess`, which correctly triggers the UAC elevation prompt and launches the application successfully.

#### Fixed: Incorrect Executable Name References
- **Issue:** Build and installer scripts referenced the old `vpnshield.exe` executable name instead of the rebranded `vaultline_vpn.exe`.
- **Root Cause:** Residual references from the pre-rebrand codebase were not fully updated during the VPN Shield to VaultLine VPN transition.
- **Fix:** Updated all script references to use the correct `vaultline_vpn.exe` filename, ensuring the build pipeline, installer, and shortcuts all point to the correct executable.

---

### Improvements

#### Improved Installer Reliability
- WireGuard detection now uses multiple verification methods (file system, registry, Windows service) for maximum compatibility
- Silent WireGuard MSI installation includes comprehensive exit code handling with clear user messages
- Installation proceeds gracefully even if WireGuard setup encounters issues, with guidance for manual installation

#### Added Automatic Elevation Handling
- Post-install application launch now correctly handles UAC elevation via `ShellExecute`
- Eliminates the need for users to manually right-click and "Run as administrator" after installation

#### Enhanced Windows 10/11 Compatibility
- Tested and verified on Windows 10 (versions 1903 through 22H2) and Windows 11 (22H2, 23H2)
- Proper handling of Windows SmartScreen and UAC prompts
- Compatible with Windows Defender and major third-party antivirus software

#### Updated Branding
- All references updated from "VPN Shield" / "vpnshield" to "VaultLine VPN" / "vaultline_vpn"
- Consistent naming across installer, shortcuts, registry entries, and documentation

---

### Known Issues

| Issue | Workaround |
|-------|------------|
| Windows SmartScreen may show a warning on first run | Click "More info" then "Run anyway" |
| Some corporate firewalls block WireGuard UDP traffic | Contact IT to allow UDP port 51820 |
| Antivirus may briefly flag the installer during extraction | Add an exception or temporarily disable real-time scanning |

---

### System Requirements

| Requirement | Specification |
|-------------|---------------|
| Operating System | Windows 10 (v1903+) or Windows 11 |
| Architecture | 64-bit (x64) |
| Disk Space | ~100 MB |
| RAM | 4 GB recommended |
| Privileges | Administrator (for installation) |

---

### Component Versions

| Component | Version |
|-----------|---------|
| VaultLine VPN | 2.0.0 |
| WireGuard (bundled) | Latest stable |
| Flutter Runtime | 3.x (Windows desktop) |
| Installer Framework | Inno Setup 6 |

---

### Upgrade Instructions

If you have a previous version of VaultLine VPN (or VPN Shield) installed:

1. **Uninstall** the previous version via Windows Settings > Apps > Installed apps
2. **Restart** your computer (recommended)
3. **Run** the new `VaultLine_VPN_Setup.exe` installer
4. Your existing `.conf` files will need to be re-imported

> **Note:** WireGuard does not need to be reinstalled if it's already present. The installer will detect it and skip the WireGuard installation step.

---

### Previous Versions

#### Version 1.0.0 (Initial Release)
- Initial release of VaultLine VPN (formerly VPN Shield)
- WireGuard-based VPN client for Windows
- Basic tunnel management (import, connect, disconnect)
- *Known issues: WireGuard MSI extraction timing bug, Error 740 on post-install launch*

---

**Copyright (c) 2026 VaultLine Technologies. All rights reserved.**
