VOOZH about

URL: https://orionbrowser.com/help

⇱ Orion Browser Help

Find clear solutions, helpful guides, and everything you need to get the most out of Orion.

Orion is a native, lightning-fast, and privacy-protecting browser for Apple users (coming soon to Linux and Windows as well), open to the web and all its standards and protocols. It's based on the WebKit open-source browser engine that also powers Apple's Safari web browser. One day, we hope everyone will say Orion is the best browser for all Apple devices.

Orion was built for professionals by professionals, but anyone can benefit from it. Installing Orion with its default settings on any Apple device will cut down on annoying ads and speed up page loads. We want everyone to enjoy the web.

Watch it here in even higher quality!

We take pride in Orion being 100% native on macOS/iOS/iPadOS/Linux.

Let's define what native means first: A native app is an app that is designed for a specific operating system and utilizes its APIs, frameworks, UI components, and guidelines.

The main benefits of native apps include:

  • Ensuring that the app feels familiar to users. For example, Apple's HIG provides guidance on how to design an intuitive UI that follows platform conventions and therefore provides a consistent experience across apps for new and veteran users.
  • It is generally accepted that Apple knows what it is doing when design is in question. It is probably a good idea to follow its lead and probably one of the reasons you own a Mac or an iPhone. Following the extensive Human Interface Guidelines (HIG) makes any designer's job easier, not harder.
  • Any long-time Mac user can easily see how Chrome or Firefox look and feel out of place on a Mac. These browsers were originally designed for Windows, but they work and look the same even on macOS or Linux, when those are clearly different operating systems with different conventions, design rules, and aesthetics.
  • Native integrations allow apps to use powerful components provided by the OS. For example, Orion utilizes Keychain to store passwords or benefits from Live Text recognition of text in images. This makes apps more powerful while being leaner and easier to build and maintain at the same time.
  • Finally, and maybe most importantly, using native components and frameworks generally makes apps faster, better for battery life, and overall snappier.

Safari is truly one of the best browsers you can use on macOS, and we're grateful to Apple for creating such a solid foundation. By basing Orion on Safari's tech stack, and adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

Google and Mozilla have made great technological strides over the past decades. We're grateful for those efforts because they help us take the next step in browser evolution.

We are... ahem.. fast.

Orion has no built-in telemetry, so it can never "phone home" and risk exposing your data. Orion is truly and verifiably a privacy-respecting browser — unlike those that only offer the illusion of privacy.

Web ads have steadily eroded the online experience with their layout crowding, page slowing, annoying popups, and insidious malware. Yet, most browsers do not block ads by default. Orion is different.

Go to Orion → Reset to reset ALL cookies, history, bookmarks, etc.

Orion has experimental support for browser extensions based on open-standard WebExtensions APIs. These are the same APIs that power browser extensions for Chrome and Firefox. So, we support many of those extensions on macOS, iOS, and iPadOS.

Yep, Orion is available for both iOS and iPadOS.

Yes, things don't always go as planned and mistakes can happen. If you ever need a previous version, you need to type a specific URL to get the version you want: https://cdn.kagi.com/updates/{CurrentOS}/{OrionVersion}.zip

Examples: Version 1.0.7 (146)

Orion's debug menu contains a number of commands that can be of interest to "advanced" users.

To enable the Debug menu, type the following in the terminal: defaults write com.kagi.kagimacOS DebugMenu 1

If you use Orion RC (release candidate), replace with: com.kagi.kagimacOS.RC

When you relaunch Orion, you'll find a new Debug menu, located to the right of the Help menu.

  • Test Web Page: Web page for testing with default configuration and without any WebExtension scripts
  • Reset Welcome Animation State: To reset the welcome animation flag to see it again on the next launch
  • Reset Preferences: Reset all global settings
  • Clear Website Data: Remove all website data (cache, cookies, etc.)
  • Clear Content Blocking Lists: Remove the Content Blocking List so that it can be initialized again on next launch
  • Clear Policy Cache: Removes WebRequest APIs request/response blocking (from WebExtensions like uBlock Origin) cache
  • Disable Resource Interceptor: Bypass any requests/response interception (used by WebRequests API) to reduce request/response delay
  • Disable Reloading Tab on WebKit Crash: Disables the auto-reload feature of the webpage when the WebContent process crashes
  • Show Debug Log: Shows WebExtension API console logs for testing/debugging
  • Factory Reset: Wipe all data and reset Orion to factory settings

You can read more about Orion's advanced features in the technical documentation.

Go to Settings → Tabs, and uncheck "Use ⌘1—⌘9 to switch tabs."

Note that Orion uses a Bookmarks bar that is separate from Favorites for more control, so you would need to copy the bookmarks you want to the Bookmarks bar folder.

The easiest way to fix incorrect icons is to purge the websites cache. You can accomplish this with the following steps:

On iOS
Settings → Data Management → Clear History and Websites Data → Toggle on Websites Cache → Tap Clear.

On macOS
Develop → Empty Cache.

To change your app icon, go to Orion > Settings > Appearance > App icon. Orion+ members can choose from a premium set of icons.

Orion supports both Chrome and Firefox extensions. Usually they're similar, but sometimes the extension developer puts extra effort in one version, maybe because they prefer that browser. For extensions in our Popular Extensions list, we already tested both and selected the one that works best.

With Orion, you can try both and use the one that works best for you. Orion is the only browser in the world that makes this choice possible!

Yes! Modern browsers have so many untapped opportunities for innovation that we had to dig in and explore. We're excited with the results, so here are a few examples.

  • Focus Mode allows the user to completely remove toolbars. Browse the web distraction-free!
  • Low Power Mode extends your battery life by reducing Orion's power consumption up to 90%.
  • Orion also features native vertical/tree-style tabs, if you prefer this alignment.

Read more about Orion features.

In short, the answer to this (and other similar questions) is:

  • If it is a native OS feature and it makes sense to have in a browser then yes, Orion as a native app will have it, sooner or later. An example is translation API which was introduced in Monterey and which we will happily integrate.
  • If it is not, then yes, Orion can still have it, if the feature request on orionfeedback.org garners enough support (upvotes).

In principle, we are building an open browser. The sky is the limit and we will build features based on our available resources and perception of what best helps our users consume the web in a faster, more secure and more productive way.

Over 700 million devices block online ads, creating the largest silent protest in human history. We too believe in a cleaner, more humane web.

Orion blocks both first-party and third-party ads, trackers and other annoyances by default to make your online adventures more enjoyable and more private. It also saves you time, battery and data. Yes, it may occasionally break a site, but in most cases the benefit outweighs the risk, and you can disable the blocker for that site in the settings menu (gear icon on the browser toolbar).

Not yet. As a small team that's spent years building Orion, we're not currently in a position to open-source it. The plan is to open-source Orion once it's self-sufficient and can sustain its own development independently. We're not there yet, but milestones like our 1.0 launch, Linux and Windows expansion are steps in that direction.

The idea that "open-source = trustworthy" only goes so far. For example, the same tech company that offers a popular open-source browser also has the largest ad/tracking network in history, with that browser playing a significant role in it. Another company with a closed-source browser (using WebKit like Orion) is at the forefront of privacy awareness and technologies in its products.

To properly protect your data, you need good answers to two questions:

Does this browser collect and send data anywhere? How does this browser make money? For the first question, what happens to your collected data is always closed-source, even on open-source browsers. Unlike Orion, most modern browsers send hundreds of data packets out, and each contains private information like your IP address and browser fingerprint, in addition to any other data they send. No open-source browser vendor has opened the code that processes this collected data.

Find out whether your browser respects your privacy by launching a network proxy (Proxyman, mitmproxy, and Charles are good options on macOS). With Orion, you'll see zero unexpected requests in your network traffic log by default. You'll see something very different with nearly every other browser.

For the second question, companies that produce popular, free, open-source browsers also generate a lot of revenue. How does that happen? Knowing where their browsers sit in that chain of revenue can tell you whether you can trust that browser with your private information.

Orion+ allows users to support Orion's development. Will it generate revenue? That's up to you. Regardless, all funding for Orion will come from its users rather than ads, tracking, data monetization, or any other indirect method.

We want Orion to be the number one browser because it uses engineering craftsmanship and attention to detail to provide a superior product experience and unmatched features that work for everyone, from power users to neophytes.

We believe this project will deliver an experience that its users value enough to support. We believe this enough to promise that we'll never resort to ads or other such funding methods. Orion makes it possible, and you make Orion possible.

We see Safari as the "reference" implementation from the OS manufacturer itself, Apple. So using Safari as our reference ensures that Orion follows best practices in design, engineering, interactions, and more. We respect the decisions that Apple made and abide by them at every point where they serve our users' interests.

Blocking web fonts can have a profound effect on news sites. On cnn.com, the average page size dropped from ~7MB to ~2MB, eliminating more than 70% of unnecessary data transfer. Those sites will load faster, use less bandwidth, and often look more readable too!

Also, on any sites that don't require logging in, disabling cookies is a great way to boost your speed and privacy.

Orion has a "Compatibility mode" in the settings menu. Enabling it will suspend your currently running extensions (the most common cause of problems) and save the setting for this website so it works when you visit it again.

If the site still fails, you may want to test it in Safari. If it works there, please report the problem to us via Orion Feedback. If you need further help with debugging or writing the bug report, please ask in our Discord server.

YouTube appears to hide the video download option on browsers that do not use the Chrome user agent. You can still download the videos by setting your User-Agent (UA) to Chrome.

On Desktop, you can do this via Settings → Websites → select User Agent from the list on the left → click + to add a new website → add youtube.com and set the user agent to Chrome → click Apply. The option to download videos should now be available.

Yes. Please use orionfeedback.org (requires registration) to submit bug reports and feature requests as well as to upvote existing posts.

Orion shares much of the same technology as Safari, such as the WebKit rendering engine. We're grateful for all the performance and privacy features that Apple and its contributors built into this tech.

The easiest way is by navigating to Orion > Reset Orion. Alternatively, you can enable the Debug menu and click Factory Reset.

We are working on Orion for Linux and Windows. For a sneak peek, you can check out the Orion blog post from November 2025.

To stay up-to-date on development for Linux and Windows, consider signing up for our newsletter:

An Android version is not currently being worked on, as the resources those would require are far greater than what is currently available. Since Orion is funded by its users only, it is entirely up to the number of subscribers and Orion+ sales we have that will enable funding a new team to make Orion for any new platform. Building a browser is not cheap, especially one on top of WebKit.

Ways you can help accelerate this:

  • Contribute to Orion development with your time
  • Help spread the word about Orion to attract more users
  • Get Orion+ and financially support development

---

If you are experiencing issues, please open a ticket with as much detail as possible, and we will review it ASAP.

For other inquiries or simply to connect, you can email support@kagi.com.