Installation - bayraktarozcan/Brave-Omega-Project GitHub Wiki
Language / Dil EN English · TR Türkçe
🔧 Installation — Complete Setup Guide
Complete installation guide for Brave Omega v3.1.0.0 (V3 version-agnostic — all Brave + Chromium versions supported).
System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| Operating System | Windows 11 26H2 (build 26300.9550) | Windows 11 26H2 (latest stable) |
| Brave Browser | 1.91.x | Latest stable (brave.com/download) |
| PowerShell | 5.1 | PowerShell 7.6.6 (5.1+ built into Windows 11 also supported) |
| Privileges | Administrator | Administrator |
| Disk Space | 1 MB | 5 MB (for backups) |
Pre-Installation Checklist
- Windows 11 installed and updated
- Brave Browser latest stable installed (brave.com/download)
- Brave version verified at brave.com/latest
- Version matches Compatibility Matrix
- Administrator account available
⚠️ Critical: Always run against the latest stable Brave release. Beta/Nightly builds may have unstable ADMX behavior.
Download
- Go to Releases
- Download
Brave-Omega-Project.zipfrom latest release - Extract to desired location (e.g.,
C:\Users\Downloads\Brave-Omega)
# Example: Extract to Downloads
Expand-Archive -Path ".\Brave-Omega-Project.zip" -DestinationPath "C:\Users\Downloads\Brave-Omega"
Installation Steps
1. Open PowerShell as Administrator
- Press
Win→ typePowerShell - Right-click Windows PowerShell → Run as Administrator
2. Navigate to Project Folder
cd "C:\Users\Downloads\Brave-Omega"
Adjust path to your extraction location.
[!IMPORTANT] Run the script from inside the
Brave-Omegafolder, with its data files next to it.BraveOmega.ps1is the entry point, but the 151 policies are not written inside the script — they are read at startup fromBraveOmega.ps1's own folder:Brave-Omega/ ├── BraveOmega.ps1 ← the script you run ├── config.json ← level order + registry targets └── Profiles/ ← the policy definitions, one JSON per tier ├── BraveOnly.json ├── Essential.json ├── Balanced.json ├── Advanced.json └── Strict.jsonThe script resolves all three paths relative to itself, so you may run it from any working directory as long as these files sit beside it. A copy of
BraveOmega.ps1on its own stops with a "config.json not found" error before any policy is applied. Copy the whole folder, not the single file.
3. Run the Script
# Bilingual entry point — first asks: Press 1 for English / Türkçe için 2'ye basın
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1"
# ...or pin the language up front (skips the question):
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language TR
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language EN
The
-ExecutionPolicy Bypassflag applies only to this single command — no permanent execution policy change.
4. Follow On-Screen Prompts
- Script asks for the target browser first (1 = Brave, 2 = Chrome;
-Browser Brave|Chromeskips the question) - Script detects running browser processes → prompts continue/cancel
- Creates timestamped
.regbackup of HKLM policy hive - Displays level selection menu (1-5) and applies policies based on selected level (24/51/83/123/151 for Brave; Brave-only policies are skipped for Chrome)
- Shows per-category success/failure summary
5. Restart Brave
- Close all Brave windows completely
- Reopen Brave
6. Verify
Navigate to brave://policy — all Essential level policies (51) should show Active.
Execution Policy Explained
| Method | Persistence | Scope | Security |
|---|---|---|---|
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
Permanent | User-wide | ❌ Creates attack surface |
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass |
Session only | Current process | ✅ Better |
PowerShell -ExecutionPolicy Bypass -File ... (used) |
Single command | Child process only | ✅ Best — no persistence |
Brave Omega v3.1.0.0 uses the safest method:
-ExecutionPolicy Bypassas a launch flag — applies only to the child process, no registry changes, no attack surface.
Verification
1. Check brave://policy
- Open
brave://policyin Brave - All Essential level policies (51) should show Active (green ✅)
2. Check Registry (Optional)
# Tier 1 (HKCU)
Get-ItemProperty "HKCU:\Software\BraveSoftware\Brave-Browser"
# Tier 2 (HKLM)
Get-ItemProperty "HKLM:\SOFTWARE\Policies\BraveSoftware\Brave"
# Tier 3 (Omaha GUID)
Get-ItemProperty "HKCU:\Software\BraveSoftware\Update\ClientState\*"
3. Check Backup File
Backup file created: HKLM_BravePolicy_YYYYMMDD_HHMMSS.reg in
%TEMP%\BravePolicyBackup. A -Reset run also leaves
HKCU_BraveSoftware_YYYYMMDD_HHMMSS.reg beside it.
Rollback / Uninstall
Via Backup File
reg import "$env:TEMP\BravePolicyBackup\HKLM_BravePolicy_20260613_120000.reg"
-Reset is the other direction: it backs both hives up first, then removes
every policy — and refuses to remove anything if that backup fails.
Manual Removal
# Remove HKLM policies
Remove-Item "HKLM:\SOFTWARE\Policies\BraveSoftware\Brave" -Recurse -Force
# Remove HKCU user preferences
Remove-Item "HKCU:\Software\BraveSoftware\Brave-Browser" -Recurse -Force
# Remove Omaha usagestats
Get-Item "HKCU:\Software\BraveSoftware\Update\ClientState\*" | ForEach-Object {
Set-ItemProperty $_.PSPath -Name "usagestats" -Value 1
}
💡 Tip: Use the
-Resetparameter for automated clean removal:PowerShell -ExecutionPolicy Bypass -File .\BraveOmega.ps1 -Reset
Common Installation Issues
| Issue | Cause | Resolution |
|---|---|---|
| "CRITICAL ERROR" on launch | Not running as Admin | Right-click PowerShell → Run as Administrator |
Script fails with [ERROR] |
HKLM permission issue | Confirm Administrator mode; re-run |
brave://policy shows no policies |
Brave not restarted | Close all Brave windows and reopen |
"Unknown" policy in brave://policy |
Version mismatch | Verify Brave version matches Compatibility Matrix |
reg export fails |
Restricted HKLM ACL | Run regedit → inspect path → check ACL entries |
File Structure After Extraction
Paths marked required at runtime are read by BraveOmega.ps1 on every run.
BRAVE OMEGA PROJECT/
│
├── .editorconfig Editor rules
├── .gitattributes Line-ending rules
├── .gitignore Git exclusion rules
├── .gitlab-ci.yml Second CI gate (GitLab)
├── .opencode/ Agent runtime configuration
├── .github/
│ ├── ISSUE_TEMPLATE/ Bug and feature request forms
│ ├── dependabot.yml Dependency update schedule
│ ├── linters/ Shared markdownlint / yamllint config
│ └── workflows/ CI/CD workflows (10 files)
├── ADMX/
│ ├── ADMX-Validate.ps1 Policy cross-reference validator
│ ├── Brave.admx Brave ADMX policy template
│ └── Brave.adml ADML language resources
├── Brave-Omega/
│ ├── BraveOmega.ps1 Unified bilingual script (EN/TR)
│ ├── config.json ** required at runtime ** level order + registry targets
│ ├── Profiles/ ** required at runtime ** policy data layer
│ │ ├── BraveOnly.json Tier 1 policies
│ │ ├── Essential.json Tier 2 delta
│ │ ├── Balanced.json Tier 3 delta
│ │ ├── Advanced.json Tier 4 delta
│ │ └── Strict.json Tier 5 delta
│ └── Docs/
│ └── Policy-Catalog.md Generated policy catalog (EN + TR)
├── Enterprise/
│ ├── levels.json Tier metadata for deployment
│ ├── BraveOnly.reg … Strict.reg Per-tier registry packages
├── Scripts/
│ ├── Invoke-CI.ps1 Local conformance gate (7 checks)
│ ├── Deploy-Brave-Omega.ps1 Deployment entry point
│ ├── Detect-Brave-Omega.ps1 Installed-state detection
│ ├── Export-PolicyCatalog.ps1 Regenerates the policy catalog
│ ├── Verify-Mirror-Sync.ps1 Bilingual mirror structure check
│ ├── Wiki-Sync.ps1 Wiki projection sync
│ ├── Release.ps1 Release automation
│ └── Mojibake-Scan.py Character-integrity scanner
├── Tests/ Pester 5.7.1 suite (32 test files + 2 helpers)
├── Wiki/ Wiki source of truth (15 pages)
├── index.html Landing page (GitHub Pages)
├── AGENTS.md Agent and contributor rules
├── README.md Documentation (EN + TR)
├── CHANGELOG.md Changelog (EN + TR)
├── CONTRIBUTING.md Contributing guide (EN + TR)
├── CODE_OF_CONDUCT.md Code of conduct
├── SECURITY.md Security policy (EN + TR)
├── PRIVACY.md Privacy statement
├── SUPPORT.md Support channels
├── RELEASE-NOTE-TEMPLATE.md Release note skeleton
├── CODEOWNERS Code ownership
├── LICENSE MIT
└── NOTICE Third-party attribution
Related Pages
- 🚀 Quick Start — One-line execution
- 🏗️ Architecture — Three-tier model
- 📋 Policy Reference — Complete policy table
- 🛡️ Security — Safety model
- 🔍 Troubleshooting — Common issues
🔧 Kurulum — Tam Kurulum Kılavuzu
Brave Omega v3.1.0.0 için tam kurulum kılavuzu (V3 sürüm-bağımsız — tüm Brave + Chromium sürümleri desteklenir).
Sistem Gereksinimleri
| Gereksinim | Minimum | Önerilen |
|---|---|---|
| İşletim Sistemi | Windows 11 26H2 (derleme 26300.9550) | Windows 11 26H2 (en güncel kararlı) |
| Brave Browser | 1.91.x | En güncel kararlı (brave.com/download) |
| PowerShell | 5.1 | PowerShell 7.6.6 (Windows 11 ile gelen 5.1+ da desteklenir) |
| Ayrıcalık | Yönetici | Yönetici |
| Disk Alanı | 1 MB | 5 MB (yedekler için) |
Kurulum Öncesi Kontrol Listesi
- Windows 11 yüklü ve güncel
- Brave Browser en güncel kararlı sürümü yüklü (brave.com/download)
- Brave sürümü brave.com/latest adresinde doğrulandı
- Sürüm, Uyumluluk Matrisi ile eşleşiyor
- Yönetici hesabı mevcut
⚠️ Kritik: Her zaman en güncel kararlı Brave sürümüne karşı çalıştırın. Beta/Nightly derlemeleri kararsız ADMX davranışına sahip olabilir.
İndirme
- Sürümlere gidin
- En son sürümden
Brave-Omega-Project.zipdosyasını indirin - İstediğiniz konuma çıkarın (ör.
C:\Users\Downloads\Brave-Omega)
# Örnek: İndirilenler klasörüne çıkarma
Expand-Archive -Path ".\Brave-Omega-Project.zip" -DestinationPath "C:\Users\Downloads\Brave-Omega"
Kurulum Adımları
1. PowerShell'i Yönetici Olarak Aç
Wintuşuna bas →PowerShellyaz- Windows PowerShell'e sağ tıkla → Yönetici olarak çalıştır
2. Proje Klasörüne Git
cd "C:\Users\Downloads\Brave-Omega"
Çıkarma konumunuza göre yolu ayarlayın.
[!IMPORTANT] Betigi, veri dosyaları yanında olacak şekilde
Brave-Omegaklasörünün içinden çalıştırın.BraveOmega.ps1giriş noktasıdır, ancak 151 politika betiğin içine gömülü değildir — çalışma anında betiğin kendi klasöründeki dosyalardan okunur:Brave-Omega/ ├── BraveOmega.ps1 ← çalıştırdığınız betik ├── config.json ← kademe sırası + kayıt defteri hedefleri └── Profiles/ ← politika tanımları, her kademe için bir JSON ├── BraveOnly.json ├── Essential.json ├── Balanced.json ├── Advanced.json └── Strict.jsonBetik bu üç yolu da kendine göre çözer; bu yüzden çalışma dizininden bağımsız olarak, dosyalar yanında durduğu sürece betiği her yerden çalıştırabilirsiniz. Tek başına kopyalanmış bir
BraveOmega.ps1, hiçbir politika uygulanmadan önce "config.json bulunamadı" hatasıyla durur. Klasörün tamamını kopyalayın, tek dosyayı değil.
3. Betiği Çalıştır
# İki dilli giriş noktası — önce dil sorar
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1"
# ...veya dili önden sabitleyin (soru sorulmaz):
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language TR
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language EN
> `-ExecutionPolicy Bypass` bayrağı **yalnızca bu tek komut için** geçerlidir — kalıcı çalıştırma ilkesi değişikliği yok.
### 4. Ekran İstemlerini Takip Et
- Betik önce hedef tarayıcıyı sorar (1 = Brave, 2 = Chrome; `-Browser Brave|Chrome` soruyu atlar)
- Betik çalışan tarayıcı süreçlerini tespit eder → devam/iptal istemi gösterir
- HKLM politika kovasının zaman damgalı `.reg` yedeğini oluşturur
- Seviye seçim menüsünü gösterir (1-5) ve seçilen seviyeye göre politikaları uygular (Brave için 24/51/83/123/151; Chrome'da Brave'e özgü politikalar atlanır)
- Kategori bazında başarı/hata özetini gösterir
### 5. Brave'i Yeniden Başlat
- **Tüm** Brave pencerelerini tamamen kapat
- Brave'i yeniden aç
### 6. Doğrula
`brave://policy` adresine git — 51 Temel seviye politikanın tümü **Etkin** görünmelidir.
---
## Çalıştırma İlkesi Açıklaması
| Yöntem | Kalıcılık | Kapsam | Güvenlik |
| -------- | ----------- | -------- | ---------- |
| `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` | Kalıcı | Kullanıcı genelinde | ❌ Saldırı yüzeyi oluşturur |
| `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass` | Yalnızca oturum | Geçerli işlem | ✅ Daha iyi |
| **`PowerShell -ExecutionPolicy Bypass -File ...`** *(kullanılan)* | **Tek komut** | **Yalnızca alt işlem** | ✅ **En iyi — kalıcılık yok** |
> **Brave Omega v3.1.0.0 en güvenli yöntemi kullanır:** `-ExecutionPolicy Bypass` başlatma bayrağı olarak — yalnızca alt işlem için geçerlidir, kayıt defteri değişikliği yok, saldırı yüzeyi yok.
---
## Doğrulama
### 1. `brave://policy` Kontrol Et
- Brave'de `brave://policy` adresini aç
- 51 Temel seviye politikanın tümü **Etkin** (yeşil ✅) görünmeli
### 2. Kayıt Defterini Kontrol Et (İsteğe Bağlı)
```powershell
# Katman 1 (HKCU)
Get-ItemProperty "HKCU:\Software\BraveSoftware\Brave-Browser"
# Katman 2 (HKLM)
Get-ItemProperty "HKLM:\SOFTWARE\Policies\BraveSoftware\Brave"
# Katman 3 (Omaha GUID)
Get-ItemProperty "HKCU:\Software\BraveSoftware\Update\ClientState\*"
3. Yedek Dosyasını Kontrol Et
Yedek dosyası oluşturuldu: HKLM_BravePolicy_YYYYMMDD_HHMMSS.reg,
%TEMP%\BravePolicyBackup altında. -Reset çalıştırması bunun yanına
HKCU_BraveSoftware_YYYYMMDD_HHMMSS.reg dosyasını da bırakır.
Geri Alma / Kaldırma
Yedek Dosyası ile
reg import "$env:TEMP\BravePolicyBackup\HKLM_BravePolicy_20260613_120000.reg"
-Reset bunun ters yönüdür: önce iki kovanın da yedeğini alır, sonra tüm
politikaları kaldırır — yedekleme başarısız olursa hiçbir şeyi kaldırmaz.
Manuel Kaldırma
# HKLM politikalarını kaldır
Remove-Item "HKLM:\SOFTWARE\Policies\BraveSoftware\Brave" -Recurse -Force
# HKCU kullanıcı tercihlerini kaldır
Remove-Item "HKCU:\Software\BraveSoftware\Brave-Browser" -Recurse -Force
# Omaha usagestats'i sıfırla
Get-Item "HKCU:\Software\BraveSoftware\Update\ClientState\*" | ForEach-Object {
Set-ItemProperty $_.PSPath -Name "usagestats" -Value 1
}
💡 İpucu: Otomatik temiz kaldırma için
-Resetparametresini kullanın:PowerShell -ExecutionPolicy Bypass -File .\BraveOmega.ps1 -Reset
Sık Karşılaşılan Kurulum Sorunları
| Sorun | Neden | Çözüm |
|---|---|---|
| Başlatmada "KRİTİK HATA" | Yönetici olarak çalışmıyor | PowerShell'e sağ tıkla → Yönetici olarak çalıştır |
Betik [HATA] ile başarısız |
HKLM izin sorunu | Yönetici modunu doğrula; yeniden çalıştır |
brave://policy politika göstermiyor |
Brave yeniden başlatılmadı | Tüm Brave pencerelerini kapat ve yeniden aç |
brave://policy'de "Bilinmiyor" politikası |
Sürüm uyuşmazlığı | Brave sürümünün Uyumluluk Matrisi ile eşleştiğini doğrula |
reg export başarısız |
Kısıtlı HKLM ACL | regedit çalıştır → yolu incele → ACL girdilerini kontrol et |
Çıkarma Sonrası Dosya Yapısı
** çalışma anında zorunlu ** ile işaretli yollar, her çalıştırmada
BraveOmega.ps1 tarafından okunur.
BRAVE OMEGA PROJECT/
│
├── .editorconfig Düzenleyici kuralları
├── .gitattributes Satır sonu kuralları
├── .gitignore Git dışlama kuralları
├── .gitlab-ci.yml İkinci kapı (GitLab)
├── .opencode/ Ajan çalışma zamanı yapılandırması
├── .github/
│ ├── ISSUE_TEMPLATE/ Hata ve özellik talebi formları
│ ├── dependabot.yml Bağımlılık güncelleme takvimi
│ ├── linters/ Paylaşılan markdownlint / yamllint yapılandırması
│ └── workflows/ CI/CD iş akışları (10 dosya)
├── ADMX/
│ ├── ADMX-Validate.ps1 Politika çapraz referans doğrulayıcı
│ ├── Brave.admx Brave ADMX politika şablonu
│ └── Brave.adml ADML dil kaynakları
├── Brave-Omega/
│ ├── BraveOmega.ps1 Birleşik iki dilli betik (EN/TR)
│ ├── config.json ** çalışma anında zorunlu ** kademe sırası + kayıt defteri hedefleri
│ ├── Profiles/ ** çalışma anında zorunlu ** politika veri katmanı
│ │ ├── BraveOnly.json 1. kademe politikaları
│ │ ├── Essential.json 2. kademe farkı
│ │ ├── Balanced.json 3. kademe farkı
│ │ ├── Advanced.json 4. kademe farkı
│ │ └── Strict.json 5. kademe farkı
│ └── Docs/
│ └── Policy-Catalog.md Üretilen politika kataloğu (EN + TR)
├── Enterprise/
│ ├── levels.json Dağıtım için kademe üstverisi
│ ├── BraveOnly.reg … Strict.reg Kademe başına kayıt defteri paketleri
├── Scripts/
│ ├── Invoke-CI.ps1 Yerel uyumluluk kapısı (7 kontrol)
│ ├── Deploy-Brave-Omega.ps1 Dağıtım giriş noktası
│ ├── Detect-Brave-Omega.ps1 Kurulu durum algılama
│ ├── Export-PolicyCatalog.ps1 Politika kataloğunu yeniden üretir
│ ├── Verify-Mirror-Sync.ps1 İki dilli yansıma yapı denetimi
│ ├── Wiki-Sync.ps1 Wiki projeksiyonu eşitleme
│ ├── Release.ps1 Sürüm otomasyonu
│ └── Mojibake-Scan.py Karakter bütünlüğü tarayıcı
├── Tests/ Pester 5.7.1 paketi (32 test dosyası + 2 yardımcı)
├── Wiki/ Wiki kaynağı (15 sayfa)
├── index.html Açılış sayfası (GitHub Pages)
├── AGENTS.md Ajan ve katkıcı kuralları
├── README.md Belgelendirme (EN + TR)
├── CHANGELOG.md Değişiklik günlüğü (EN + TR)
├── CONTRIBUTING.md Katkı rehberi (EN + TR)
├── CODE_OF_CONDUCT.md Davranış kodu
├── SECURITY.md Güvenlik politikası (EN + TR)
├── PRIVACY.md Gizlilik beyanı
├── SUPPORT.md Destek kanalları
├── RELEASE-NOTE-TEMPLATE.md Sürüm notu iskeleti
├── CODEOWNERS Kod sahipliği
├── LICENSE MIT
└── NOTICE Üçüncü taraf atıfları
İlgili Sayfalar
- 🚀 Hızlı Başlangıç — Tek satırda çalıştırma
- 🏗️ Mimari — Üç katmanlı model
- 📋 Politika Başvurusu — Tam politika tablosu
- 🛡️ Güvenlik — Güvenlik modeli
- 🔍 Sorun Giderme — Sık karşılaşılan sorunlar