Windows SmartScreen Warning
Learn how to safely install KubeGraf on Windows despite SmartScreen security warnings.
What is SmartScreen?
Windows SmartScreen is a security feature that warns users about potentially unsafe applications. When you download KubeGraf, you may see a warning like:
Windows protected your PC
Microsoft Defender SmartScreen prevented an unrecognized app from starting.
✅ Is KubeGraf Safe? Yes, KubeGraf is completely safe!
- Verified: Used by thousands of developers worldwide
- No Malware: 100% clean, regularly scanned
- Actively Maintained: Regular security updates and patches
How to Install Despite the Warning
Method 1: Standard Installation (Recommended)
- Download the installer from GitHub Releases
- Double-click the
.exe file
- When the warning appears:
- Click "More info" at the bottom
- Click "Run anyway"
- Continue with the installation wizard
Method 2: Use Scoop (No Warning)
If you prefer to avoid the warning entirely:
# Add KubeGraf bucket
scoop bucket add kubegraf https://github.com/kubegraf/scoop-bucket
# Install KubeGraf
scoop install kubegraf
Scoop installers are trusted by Windows and won't show SmartScreen warnings.
Why Does This Happen?
Windows SmartScreen shows warnings for:
- Unsigned software: Applications without code signing certificates
- Unknown publishers: Software from publishers Windows doesn't recognize yet
- New applications: Software that hasn't been downloaded by many users
This is Windows being cautious to protect users, but it can be overly cautious for legitimate open-source software.
What We're Doing About It
We're working on solutions to remove this warning:
- Code Signing Certificate: We're planning to get a code signing certificate ($200-300/year) to sign our installers
- Building Reputation: As more users download KubeGraf, Windows will eventually trust it automatically
- Alternative Distribution: We support Scoop, which doesn't have this issue
Verification Steps (Optional)
If you want extra assurance:
- Check the Source: Visit GitHub and review the code
- Scan with Antivirus: Run a virus scan on the downloaded file
- Check File Hash: Verify the SHA256 hash matches the one on GitHub releases
- Read Reviews: Check user feedback and GitHub issues
Common Questions
Q: Is this a virus?
A: No, KubeGraf is completely safe. It's open-source software with all code publicly available.
Q: Why isn't it signed?
A: Code signing certificates cost $200-500/year. We're working on getting one, but for now, the installer is unsigned.
Q: Will this always show?
A: No. Once we get a code signing certificate, future installers won't show this warning.
Q: Can I trust it?
A: Yes! KubeGraf is open source, meaning you can review all the code yourself on GitHub.
Need Help?
If you have questions or concerns:
Remember: This warning is normal for open-source software. Click "More info" → "Run anyway" to proceed safely. ✅
← Back to Installation Guide