Download & install
Install Oleafly on macOS, Windows, or Linux, then learn what the app may download on first use.
Installing Oleafly is a download and a double-click. No account, no sign-in, and no separate LaTeX distribution: the compiler ships inside the app.
Download the app
Section titled “Download the app”Grab the latest installer from the releases page (opens in a new tab), or use the Download button on oleafly.com, which resolves the installer for your platform when it can.
| Platform | Download | What to do |
|---|---|---|
| macOS (Apple Silicon) | _aarch64.dmg | M1 or newer. Open the dmg, drag Oleafly to Applications. |
| macOS (Intel) | _x64.dmg | Intel Macs. Open the dmg, drag Oleafly to Applications. |
| Windows (x86_64) | .msi or -setup.exe | Run either installer and follow the prompts. |
| Linux (x86_64) | .AppImage, .deb or .rpm | Use the AppImage on most distributions, the Debian package on Debian-based systems, or the RPM on Fedora. |
| Linux (ARM64) | .AppImage, .deb or .rpm | Native packages for ARM64 Linux systems. |
On Linux, Oleafly needs glibc 2.35 or newer (2022-era or later: Ubuntu 22.04+, Fedora 36+, Debian 12+).
Not sure which Mac you have? Open the Apple menu and choose About This Mac. A Chip line means Apple Silicon, a Processor line that names Intel means an Intel Mac.
Current shipping targets are macOS Apple Silicon, macOS Intel, Windows x64, Linux x64, and Linux ARM64. Windows on ARM does not have a native package yet.
First launch
Section titled “First launch”Open the disk image, drag Oleafly to Applications, then launch it. Use the official installer. If macOS blocks it, check System Settings → Privacy & Security for the first-launch message.
Windows
Section titled “Windows”Run the MSI or setup executable and follow the installer. If Windows shows a reputation warning, verify the download came from the official release before continuing. The installer puts the Microsoft Visual C++ runtime file that Typst and the LaTeX language server need next to the app, so you don’t have to install it separately.
Use the Debian or RPM package with your package manager, or make the AppImage executable and open it:
chmod +x Oleafly_*.AppImage./Oleafly_*.AppImageOleafly needs glibc 2.35 or newer. Choose the package for your computer’s architecture.
The .deb and .rpm packages keep Oleafly’s own Tectonic, Pandoc, and Typst in /usr/libexec/oleafly, so they install next to your distribution’s Pandoc. When you start the AppImage, it adds itself to your applications menu, which Wayland desktops such as GNOME need before they show its icon in the dock. It leaves the menu alone when an installed package or another tool has already added Oleafly, and if you delete the entry, it stays deleted.
The Debian package has a description, so Ubuntu’s App Center shows what Oleafly is before you install it. It also carries AppStream data, so software centers show the icon, license, screenshots, and version once Oleafly is installed. The app appears under Office in your app menu. On Linux, as on Windows, Oleafly draws its own title bar. Its toolbar sits at the top with minimize, maximize, and close buttons. Drag the toolbar to move the window, double-click it to maximize, and drag any edge or corner to resize.
The first compile downloads TeX packages
Section titled “The first compile downloads TeX packages”The first time you compile a document on the bundled Tectonic engine, it downloads the packages that document needs and caches them. The first compile on a computer also fetches a batch of commonly used packages in one go, so later documents start faster. That needs a network connection and can take a few minutes on a slow line. The compile time limit waits while packages are still arriving, and if Oleafly’s package mirror fails, the compile falls back to the upstream source. Later compiles of the same document are fast and work offline. A document that needs a package you have not cached yet triggers another one-time fetch. See Compiling, including strict offline mode.
Optional: a TeX distribution
Section titled “Optional: a TeX distribution”Tectonic covers most documents. When a project needs pdfLaTeX, upLaTeX, or another compiler from a full TeX distribution, Oleafly uses the MacTeX, TeX Live, MiKTeX, or TinyTeX already on your computer. If there isn’t one, it can install TinyTeX for you from Settings → Engines → LaTeX, or straight from the compile error. TinyTeX needs no administrator rights, the download is about 250 MB, and Oleafly asks for about 2 GB of free disk space.
- On Linux, TinyTeX uses the system Perl. Install it first if it’s missing:
sudo apt install perl,sudo dnf install perl, orsudo pacman -S perl. - On Windows, MiKTeX needs Perl to run
latexmk. Install Strawberry Perl, or install TinyTeX, which brings its own. - On Debian, Ubuntu, and Fedora, a TeX Live you installed with
aptordnfalso gets its LaTeX packages fromaptordnf. Oleafly tells you what to install but doesn’t change it.
Your files stay as plain folders on disk. Tokens and AI keys live in encrypted, owner-restricted local files. Online features include hosted AI, GitHub sync, package downloads, citation lookups, and update checks. See Philosophy.
Staying up to date
Section titled “Staying up to date”Oleafly checks a signed release feed, shows release notes, and installs in place when you confirm. On Linux, automatic replacement works for AppImage installs. You can also check from Settings → Help & About. See Updates.
Build from source
Section titled “Build from source”Follow the desktop development guide (opens in a new tab) for prerequisites, engine downloads, and local builds.
Next steps
Section titled “Next steps”- Getting started: first project to first PDF in a couple of minutes.
- Templates: bundled starters and downloadable packs.
- Oleafly Learn: free LaTeX and research writing curriculum on the web.
- Command-line tool: build, check and sync projects from a terminal, and connect coding agents.