Skip to content

Installation

github-actions[bot] edited this page Oct 2, 2026 · 40 revisions

Language / Dil   EN English  ·  TR Türkçe

🔧 Installation — Complete Setup Guide

Complete installation guide for Brave Omega v2.8.1.1 (Brave 1.96.59 / Chromium 154.0.8037.58 compatibility validation).


System Requirements

Requirement Minimum Recommended
Operating System Windows 11 Windows 11 25H2 (latest stable)
Brave Browser 1.91.x Latest stable (brave.com/download)
PowerShell 5.1 5.1+ (built into Windows 11)
Privileges Administrator Administrator
Disk Space 1 MB 5 MB (for backups)

Pre-Installation Checklist

⚠️ Critical: Always run against the latest stable Brave release. Beta/Nightly builds may have unstable ADMX behavior.


Download

  1. Go to Releases
  2. Download Brave-Omega-Project.zip from latest release
  3. 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 → type PowerShell
  • Right-click Windows PowerShell → Run as Administrator

2. Navigate to Project Folder

cd "C:\Users\Downloads\Brave-Omega"

Adjust path to your extraction location.

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 Bypass flag applies only to this single command — no permanent execution policy change.

4. Follow On-Screen Prompts

  • Script detects running Brave → prompts continue/cancel
  • Creates timestamped .reg backup of HKLM policy hive
  • Displays level selection menu (1-5) and applies policies based on selected level (24/51/83/123/151)
  • 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 v2.8.1.1 uses the safest method: -ExecutionPolicy Bypass as a launch flag — applies only to the child process, no registry changes, no attack surface.


Verification

1. Check brave://policy

  • Open brave://policy in 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: BraveOmega_HKLM_YYYYMMDD_HHMMSS.reg in script directory.


Rollback / Uninstall

Via Backup File

reg import "BraveOmega_HKLM_20260613_120000.reg"

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 -Reset parameter 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

BRAVE OMEGA PROJECT/
│
├── .gitignore                        # Git exclusion rules
├── .gitattributes
├── LICENSE                           MIT
├── README.md                         Documentation (EN + TR)
├── CHANGELOG.md                      Changelog
├── CONTRIBUTING.md                   Contributing guide (EN + TR)
├── SECURITY.md                       Security policy (EN + TR)
├── index.html                        Landing page (GitHub Pages)
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.yaml           Bug report template
│   │   └── feature_request.yaml      Feature request template
│   └── workflows/
│   └── admx-validate.yml             ADMX validation script
├── ADMX/
│   ├── ADMX-Validate.ps1             ADMX cross-reference validator
│   ├── Brave.admx                    Brave ADMX policy template
│   └── Brave.adml                    Brave ADML language resources
└── Brave-Omega/
        BraveOmega.ps1             Unified bilingual script (EN/TR)
└── Tests/                         Pester test suite (28 files)
            FullPipeline.Tests.ps1          Unit + integration tests
            FullPipeline-TR.Tests.ps1       Unit + integration tests (TR)
            └── *.Tests.ps1                  Phased policy tests (26 files)

Related Pages



🔧 Kurulum — Tam Kurulum Kılavuzu

Brave Omega v2.8.1.1 için tam kurulum kılavuzu (Brave 1.96.59 / Chromium 154.0.8037.58 uyumluluk doğrulaması).


Sistem Gereksinimleri

Gereksinim Minimum Önerilen
İşletim Sistemi Windows 11 Windows 11 25H2 (en güncel kararlı)
Brave Browser 1.91.x En güncel kararlı (brave.com/download)
PowerShell 5.1 5.1+ (Windows 11 ile birlikte gelir)
Ayrıcalık Yönetici Yönetici
Disk Alanı 1 MB 5 MB (yedekler için)

Kurulum Öncesi Kontrol Listesi

⚠️ 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

  1. Sürümlere gidin
  2. En son sürümden Brave-Omega-Project.zip dosyasını indirin
  3. İ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ç

  • Win tuşuna bas → PowerShell yaz
  • 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.

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 çalışan Brave'i 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 (24/51/83/123/151)
- 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 v2.8.1.1 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: BraveOmega_HKLM_YYYYMMDD_HHMMSS.reg betik dizininde.


Geri Alma / Kaldırma

Yedek Dosyası ile

reg import "BraveOmega_HKLM_20260613_120000.reg"

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 -Reset parametresini 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ı

BRAVE OMEGA PROJECT/
│
├── .gitignore                        # Git dışlama kuralları
├── .gitattributes
├── LICENSE                           MIT
├── README.md                         Belgelendirme (EN + TR)
├── CHANGELOG.md                      Değişiklik günlüğü
├── CONTRIBUTING.md                   Katkı rehberi (EN + TR)
├── SECURITY.md                       Güvenlik politikası (EN + TR)
├── index.html                        Açılış sayfası (GitHub Pages)
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.yaml           Hata raporu şablonu
│   │   └── feature_request.yaml      Özellik talebi şablonu
│   └── workflows/
│   └── admx-validate.yml             ADMX validation script
├── ADMX/
│   ├── ADMX-Validate.ps1             ADMX çapraz referans doğrulama betiği
│   ├── Brave.admx                    Brave ADMX şablonu
│   └── Brave.adml                    Brave ADML dil kaynakları
└── Brave-Omega/
        BraveOmega.ps1             Birleşik iki dilli betik (EN/TR)
└── Tests/                         Pester test paketi (23 dosya)
        FullPipeline.Tests.ps1          Birim + entegrasyon testleri
        FullPipeline-TR.Tests.ps1       Birim + entegrasyon testleri (TR)
        └── *.Tests.ps1                  Aşamalı politika testleri (21 dosya)

İlgili Sayfalar

Clone this wiki locally