Skip to content
Oleaflyv0.4.12

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.

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.

PlatformDownloadWhat to do
macOS (Apple Silicon)_aarch64.dmgM1 or newer. Open the dmg, drag Oleafly to Applications.
macOS (Intel)_x64.dmgIntel Macs. Open the dmg, drag Oleafly to Applications.
Windows (x86_64).msi or -setup.exeRun either installer and follow the prompts.
Linux (x86_64).AppImage, .deb or .rpmUse the AppImage on most distributions, the Debian package on Debian-based systems, or the RPM on Fedora.
Linux (ARM64).AppImage, .deb or .rpmNative 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.

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.

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:

Terminal window
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage

Oleafly 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 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.

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, or sudo 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 apt or dnf also gets its LaTeX packages from apt or dnf. Oleafly tells you what to install but doesn’t change it.

See LaTeX engines & packages.

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.

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.

Follow the desktop development guide (opens in a new tab) for prerequisites, engine downloads, and local builds.

  • 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.
Image preview

AI answers couldn’t load

Try again, or search the documentation.