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, 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) | .dmg | M1 or newer. 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 or .deb | Use the AppImage on most distributions or the Debian package on Debian-based systems. |
| Linux (ARM64) | .AppImage or .deb | Native packages for ARM64 Linux systems. |
On Linux, Oleafly needs glibc 2.39 or newer (2024-era or later: Ubuntu 24.04+, Fedora 40+, Debian 13+).
Current shipping targets are macOS Apple Silicon, Windows x64, Linux x64, and Linux ARM64. Intel Macs and Windows on ARM do not have native packages 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.
Use the Debian package with your package manager, or make the AppImage executable and open it:
chmod +x Oleafly_*.AppImage./Oleafly_*.AppImageOleafly needs glibc 2.39 or newer. Choose the package for your computer’s architecture.
The first compile downloads TeX packages
Section titled “The first compile downloads TeX packages”The first time you compile a document, the bundled Tectonic engine downloads the packages that document needs and caches them. That needs a network connection and can take a minute. 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.
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 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.