From e57e3748c3e9e89ef1465300a67fdefae297b1f1 Mon Sep 17 00:00:00 2001
From: majjo <majjo@noxgroup.xyz>
Date: Thu, 30 Apr 2026 12:50:42 +0200
Subject: [PATCH] add install guide for signed msix releases

---
 INSTALL.md | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 INSTALL.md

diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 00000000..fd5c4bcd
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1,66 @@
+# Installing Wino Mail (Fork Release)
+
+This fork is currently distributed as a signed `.msix` package using a self-signed certificate.
+
+Because of that, Windows will **not** trust the package by default until you install the included certificate.
+
+## Files you need
+
+From the release, download:
+
+- `Wino.Mail.WinUI_2.0.8.0_x64.msix`
+- the included certificate file (`.cer`)
+
+## Step 1: Install the certificate
+
+1. Double-click the `.cer` file.
+2. Click **Install Certificate**.
+3. Choose **Current User**.
+4. Select **Place all certificates in the following store**.
+5. Choose **Trusted People**.
+6. Finish the wizard.
+
+If Windows still refuses to install the app afterward, also install the same certificate into:
+
+- **Trusted Root Certification Authorities**
+
+## Step 2: Install the app package
+
+### Option A — Try normal install first
+
+Double-click the `.msix` package and follow the App Installer prompts.
+
+### Option B — Recommended fallback
+
+If App Installer shows a certificate trust error, open **PowerShell as Administrator** and run:
+
+```powershell
+Add-AppxPackage "C:\path\to\Wino.Mail.WinUI_2.0.8.0_x64.msix"
+```
+
+Replace the path with the actual location of the downloaded `.msix` file.
+
+## Verifying the install
+
+To confirm the app is installed, run:
+
+```powershell
+Get-AppxPackage | Where-Object Name -like "*Wino*"
+```
+
+You can then launch **Wino Mail** from the Start menu.
+
+## Uninstalling
+
+To uninstall the forked package:
+
+```powershell
+Get-AppxPackage MajjoDuran.WinoMail | Remove-AppxPackage
+```
+
+## Notes
+
+- This fork currently uses a self-signed certificate for distribution.
+- That means users must trust the included certificate before Windows will install the package cleanly.
+- The `.cer` file is safe to share publicly.
+- The private signing certificate (`.pfx`) must **never** be shared.