Updates
How Surge updates itself
Surge checks for updates automatically on launch using Sparkle, the standard auto-update framework for Mac apps. New versions install in the background and apply on next restart.
Checking your current version
- Open Surge → About Surge Browser, or visit
surge://settings/help.
- Your current version is shown under "Surge Browser."
For example: Version 1.1.1 (Official Build) (arm64). The architecture in parentheses tells you whether you're on the Apple Silicon (arm64) or Intel (x86_64) build.
Checking for updates manually
Surge checks automatically on launch, but you can also force a check:
- Open Surge → About Surge Browser.
- Click Check for updates.
If an update is available, Sparkle will download it in the background and prompt you to restart when it's ready.
Where updates come from
Updates are downloaded from our GitHub releases at github.com/martense1106/surge-updates/releases. Each release is signed, notarized by Apple, and verified by Sparkle before installation.
Still need help?
If you can't find the answers you need, contact us.
Updates
Update errors
If Surge can't download or install an update, it'll show an error. Here's what each one means and what to do.
"Update is improperly signed"
This means the update Sparkle downloaded didn't match the signature we published. It's rare, and it usually clears up on its own. Sparkle will try again on the next launch.
If it persists across multiple launches, the safest fix is a manual reinstall:
- Download the latest version.
- Quit Surge.
- Open the DMG and drag the new Surge Browser into Applications, replacing the existing copy.
- Open Surge. Your data, like bookmarks, history, passwords, and sign-in, stays put.
"The update couldn't be downloaded"
This usually means a network problem. Check your internet connection and try again. If it keeps failing, do the manual reinstall above.
"Update verification failed"
Same fix as the manual reinstall above. Sparkle wouldn't let the install proceed if it didn't trust the update, so this isn't dangerous. It just means the auto-update couldn't complete.
Manual reinstalls are safe
Reinstalling Surge by replacing the app in Applications keeps all your local data. Your profile, bookmarks, history, passwords, extensions, and User Cooperative sign-in are stored separately from the app bundle.
Still need help?
If you can't find the answers you need, contact us.
When something breaks
"Surge Browser can't be opened…"
If macOS shows "Surge Browser can't be opened because Apple cannot check it for malicious software," it means Gatekeeper couldn't verify the notarization. The fix is to open it manually the first time.
The fix
- Open the Applications folder in Finder.
- Right-click (or Control-click) Surge Browser and choose Open.
- In the dialog that appears, click Open.
You'll only need to do this once. After the first launch, Surge opens normally.
Why this happens
Every release of Surge is signed with our Apple Developer ID and notarized by Apple before we ship it. Occasionally, usually right after a release or if your Mac has spotty internet, Gatekeeper can't reach Apple's servers to verify the notarization and shows the warning out of caution. Right-clicking and choosing Open tells macOS you trust the app, and the verification continues in the background.
Still need help?
If you can't find the answers you need, contact us.
When something breaks
Surge is slow or unresponsive
Try these in order. Most slowness comes from a single misbehaving tab or extension, not from Surge itself.
1. Open the Task Manager to find the culprit
- Press
⇧Esc, or open Window → Task Manager.
- Sort by Memory or CPU to find what's using the most.
- Select the offending process and click End process.
If a specific tab is consistently the problem, try closing and reopening it.
2. Disable extensions one at a time
Extensions can quietly slow down every page you visit. Open surge://extensions and turn each one off, then test whether things improve.
3. Clear the cache
A bloated cache can slow page loads. Press ⌘⇧⌫, choose Cached images and files, set the time range to All time, and click Clear data.
4. Turn off hardware acceleration
If Surge is sluggish across the board, especially when scrolling or playing video, your graphics drivers may not be cooperating. Try toggling hardware acceleration:
- Open Settings → System.
- Toggle Use graphics acceleration when available off.
- Restart Surge and test.
If turning it off helps, leave it off. If it doesn't help, turn it back on.
5. Try a clean profile
If nothing else works, a corrupted profile may be the issue. See Resetting, reporting, and starting over for the reset flow.
Still need help?
If you can't find the answers you need, contact us.
When something breaks
A page won't load or render correctly
If a single page is broken but other sites work, the problem is usually local: cache, cookies, or an extension. Try these in order.
1. Hard reload
A normal reload (⌘R) uses cached files. A hard reload forces a fresh download:
- Press
⌘⇧R.
- Or hold Shift and click the reload button.
2. Open the page in an incognito window
Press ⌘⇧N and try the page there. Incognito windows don't use your extensions, cookies, or cache. If the page works in incognito but not in a regular window, the problem is one of those three.
3. Clear cookies for the specific site
Some pages get into a bad state when their cookies are stale or corrupted:
- Open Settings → Privacy and security → Site settings → View permissions and data stored across sites.
- Search for the site.
- Click the trash icon to clear its data.
- Reload the page.
4. Disable extensions
Ad blockers, script blockers, and privacy extensions can break pages they don't recognize. Open surge://extensions and turn each one off, then reload.
5. Check if the site is down
If none of the above helps, the issue may not be on your end. Try the page in another browser or on another network to confirm.
Still need help?
If you can't find the answers you need, contact us.
When something breaks
Video won't play
If a video won't play, the cause is almost always one of three things: the site uses DRM (which Surge doesn't currently support), your cache is in a bad state, or hardware acceleration is interfering.
If the site uses DRM
Surge doesn't currently support DRM-protected video playback. Netflix, HBO Max, Hulu, Disney+, Apple TV+, Amazon Prime Video, and similar streaming services rely on DRM to play their content. On those sites, video won't play in Surge.
The reason and the longer story is in Chipping in. The short version: DRM licensing is expensive, and we believe most DRM streaming happens on TVs and other devices anyway. We'd rather put that money toward expanding to other platforms.
If it's a non-DRM site
For sites like YouTube, Vimeo, and most embedded video, try these in order:
- Hard reload the page with
⌘⇧R.
- Clear the site's cookies and data (see the previous article for how).
- Disable extensions at
surge://extensions — ad blockers in particular can break video players.
- Turn off hardware acceleration at Settings → System and restart Surge.
Still need help?
If you can't find the answers you need, contact us.
Recovery
Sign-in problems
Most sign-in trouble comes from a stuck Clerk session. The fix is to clear cookies for the sign-in domain and try again.
"Allow Surge Browser access" won't let me switch accounts
If you signed in once and want to sign in as a different user, Clerk may show you an "Allow Surge Browser access" screen instead of a fresh sign-in form. That screen doesn't have a way to switch accounts.
The fix is to clear cookies for the Clerk domain. See Adding a second profile in Getting started for the exact steps.
I'm stuck on a loading screen after signing in
Try these in order:
- Close the tab and reopen Surge.
- If that doesn't help, clear Clerk's cookies: Settings → Privacy and security → Site settings → View permissions and data stored across sites → search "clerk.usercooperative.com" → click the trash icon.
- Try signing in again.
I forgot my password
On the sign-in screen, click Forgot password? Clerk will send a reset link to your email.
I can't access the email I signed up with
If you've lost access to the email tied to your User Cooperative account, contact us. We'll work with you to recover or transfer the account. Don't create a new account in the meantime. Your clicks and dividends are tied to the original account, and creating a duplicate splits them.
Still need help?
If you can't find the answers you need, contact us.
Recovery
Resetting, reporting, and starting over
When nothing else works: reset Surge's settings, report a bug, or, as a last resort, uninstall and reinstall.
Reset Surge to defaults
This resets your settings, like your startup page, search engine, pinned tabs, and content settings, without deleting your bookmarks, history, or passwords.
- Open
surge://settings/reset, or Settings → Reset settings.
- Click Restore settings to their original defaults.
- Click Reset settings to confirm.
Reporting a bug
If you've hit something that doesn't look right, let us know at usercooperative.com/contact-us. Helpful things to include:
- Your Surge version (from Surge → About Surge Browser).
- Your macOS version.
- The steps that triggered the issue.
- Whether it happens in an incognito window too (which rules out extensions and cookies).
- Screenshots, if relevant.
Crash reports
When Surge crashes, a report is sent automatically. You don't need to do anything. See What data Surge collects for what's in the report.
Uninstalling Surge
If you want to remove Surge entirely:
- Quit Surge.
- Drag Surge Browser from your Applications folder to the Trash.
- Empty the Trash.
Your local Surge data, like bookmarks, history, passwords, and profile, stays in ~/Library/Application Support/Surge/. To remove that too, drag the folder to the Trash.
Uninstalling doesn't delete your User Cooperative account
Removing Surge from your Mac doesn't touch your User Cooperative account, your lifetime click count, or your dividends. Those live on our servers. To delete your account entirely, see Managing your User Cooperative account.
Still need help?
If you can't find the answers you need, contact us.