# 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

Grab the latest installer from the [releases page](https://github.com/Oleafly/Oleafly/releases/latest), or use the Download button on [oleafly.com](https://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

### macOS

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

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.

### Linux

Use the Debian package with your package manager, or make the AppImage executable and open it:

```bash
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage
```

Oleafly needs glibc 2.39 or newer. Choose the package for your computer's architecture.

## 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](/docs/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](/docs/philosophy/).

## 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](/docs/updates/).

## Build from source

Follow the [desktop development guide](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) for prerequisites, engine downloads, and local builds.

## Next steps

- [Getting started](/docs/getting-started/): first project to first PDF in a couple of minutes.
- [Templates](/docs/templates/): bundled starters and downloadable packs.
- [Oleafly Learn](/learn/): free LaTeX and research writing curriculum on the web.