Skip to content

Quick Start

Aether edited this page Sep 8, 2025 · 1 revision

Ora Browser Quick Start - Hosting Setup

🚀 Quick Setup (5 minutes)

Note: The release script now auto-increments version numbers. Just run ./create-release.sh without arguments for patch releases.

1. Setup Sparkle Tools

brew install --cask sparkle
./setup-sparkle-tools.sh
./setup-sparkle.sh

2. Build & Sign Release

# Auto-increment version (recommended)
./create-release.sh

# Or specify version manually
./create-release.sh 0.0.1

3. Host Files

Option A: GitHub Pages (Easiest)

# Create gh-pages branch
git checkout -b gh-pages
git rm -rf .
cp ../appcast.xml .
git add appcast.xml
git commit -m "Add appcast for updates"
git push origin gh-pages

# Enable in GitHub: Settings → Pages → Source: gh-pages

Option B: GitHub Releases

  • Upload Ora-Browser.dmg to GitHub Releases
  • Upload appcast.xml to any web host

4. Update App Config

Edit project.yml:

settings:
  base:
    SUFeedURL: https://the-ora.github.io/browser/appcast.xml
    SUPublicEDKey: YOUR_PUBLIC_KEY_HERE

5. Test

xcodegen
# Build and run app
# Go to Settings → General → Check for Updates

📋 What Gets Hosted Where

File Location Purpose
build/appcast.xml Public web server Update feed for Sparkle
build/Ora-Browser.dmg GitHub Releases App installer download
build/dsa_pub.pem App bundle Public key for verification

🔗 URLs You'll Need

  • Appcast: https://the-ora.github.io/browser/appcast.xml
  • DMG: https://github.com/the-ora/browser/releases/download/v{VERSION}/Ora-Browser.dmg
  • Public Key: Copy from dsa_pub.pem

✅ Checklist

  • DSA keys generated (dsa_priv.pem, dsa_pub.pem)
  • Release built and signed (Ora-Browser.dmg)
  • Appcast updated with real signature
  • Appcast hosted at public URL
  • DMG uploaded to GitHub Releases
  • SUFeedURL updated in app
  • SUPublicEDKey added to app
  • Xcode project regenerated

🆘 Need Help?

  • Keys not working: Run ./setup-sparkle.sh again
  • Signature invalid: Use sign_update command output exactly
  • Update not found: Check SUFeedURL in Info.plist
  • DMG won't download: Verify GitHub release is public

See docs/HOSTING_SETUP.md for detailed instructions. </xai:function_call: write> /Users/keni/code/ora/browser/docs/QUICK_START.md

Ora Wiki

🚀 Getting Started

📦 Deployment & Updates

📊 Data & Storage

🆘 Help & Support

Clone this wiki locally