Leafage Help
Download

Installing Leafage

Download Leafage, open it on macOS, and connect your Codex subscription so you can start generating.

Last updated June 25, 2026

Leafage is a native macOS app. Installing it takes a couple of minutes: download the app, move it to Applications, and connect it to the Codex subscription you already have.

System requirements

  • macOS 13 (Ventura) or later, on Apple Silicon or Intel.
  • An active Codex subscription, authenticated on the same Mac. Leafage uses your local Codex setup to generate images — it does not run its own model.
  • Around 300 MB of free disk space for the app, plus room for the projects and images you create.

Windows isn't available yet

Leafage is macOS-only for now. A Windows version is in progress — there's nothing to install on Windows today.

Step 1 — Download the app

Download the latest build from the button on the Leafage homepage, or grab it directly:

https://downloads.leafage.app/desktop/latest/leafage-macos-universal.dmg

The download is a universal .dmg that runs on both Apple Silicon and Intel Macs.

Step 2 — Install it

  1. Open the downloaded Leafage.dmg file.
  2. In the window that appears, drag the Leafage icon onto the Applications folder.
  3. Eject the disk image, then open Leafage from your Applications folder or Launchpad.

If macOS blocks the first launch

The first time you open Leafage, macOS Gatekeeper may warn that it was downloaded from the internet. This is expected for a newly installed app.

  • Click Open if you see an “Are you sure you want to open it?” prompt.
  • If the button is missing, open System Settings → Privacy & Security, scroll to the Security section, and click Open Anyway next to the Leafage message.

Tip

You only need to do this once. After the first successful launch, Leafage opens normally.

Step 3 — Connect your Codex subscription

Leafage generates images through Codex running locally on your Mac, so it needs to find an authenticated Codex setup.

  1. Open Leafage and go to Settings -> Codex.
  2. Leafage looks for your existing Codex install automatically. If it’s found and signed in, the Codex CLI section shows that Codex is ready.
  3. If it isn’t found, follow Codex isn’t detected to install or sign in to Codex, then return here.

Codex is required to generate

Without a connected Codex subscription, you can still open and arrange the canvas, but generation will be disabled. See Codex isn't detected if the status never turns green.

Step 4 — Choose where projects are saved

On first run, Leafage asks for a Project Location — a folder on your Mac where canvases, generation history, and generated images are stored.

Everything stays local to your machine; nothing is uploaded to Leafage. You can change this folder later in Settings -> General.

What you get on the free trial

New installs include 50 free generated images so you can try the full workflow before buying. After that, a one-time $79 lifetime license unlocks unlimited generation — no subscription, with lifetime updates.

Updating Leafage

Leafage checks for updates on launch and will prompt you when a new version is available. To update manually, download the latest .dmg using the link above and replace the app in your Applications folder — your projects and license are unaffected.

Next steps