Documentation
Looking for specifics? Check our documentation, it might have what you need. We're still building it out, but the basics are covered and we're adding more every week.
If your answer's anywhere official, it's probably there.
Find clear solutions, helpful guides, and everything you need to get the most out of Orion.
Looking for specifics? Check our documentation, it might have what you need. We're still building it out, but the basics are covered and we're adding more every week.
If your answer's anywhere official, it's probably there.
Our Discord community has answers. Thousands of Orion users sharing tips, solving problems, and pushing the browser to its limits.
The team's there too,︎ we actually show up.
Orion is a native, lightning-fast, and privacy-protecting browser for Apple users, 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.
Let's define what native means first: A native macOS app is an app that is specifically designed for the Apple macOS operating system and utilizes its APIs, frameworks, UI components, and guidelines.
The main benefits of native apps include:
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 is lightweight, with advanced memory-use technology that includes the best closed-tab management of all contemporary browsers.
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 Settings → Orion → Manage to search and clear individual site cookies OR Orion → Reset to reset ALL cookies, history, bookmarks, etc.
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 0.99.125-beta
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.
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.
There are two possible ways. For a quick and easy solution using Finder:
To revert back to the original icon, select and press delete on the icon.
This works best for previewing the icon change, but will not work across updates, as the icon will be reset. For that, you can use an app like Pictogram.
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.
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.
Read more about Orion features.
In short, the answer to this (and other similar questions) is:
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).
We're working on it! We've started with some of our components and intend to open more in the future.
Forking WebKit, porting hundreds of APIs, and writing a browser app from scratch has been challenging for our small team. Properly maintaining an open-source project takes time and resources that we are currently short on. If you would like to contribute, please consider becoming active on orionfeedback.org.
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 Mac 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:
---
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.