Help

Install Flora, sign in and launch your first instance. Answers to common questions are at the end.

Getting started

  1. Install Flora Client

    On Windows, get FloraSetup.exe from the download page, run it and choose Install. No administrator rights are needed. Or, with WinGet, run winget install xdpxi.FloraClient. On a Mac or on Linux, install with Homebrew from the same page: brew install --cask xdpxi/tap/flora-client on macOS, or brew install xdpxi/tap/flora-client on Linux.

  2. Sign in with Microsoft

    Choose Sign In. A Microsoft sign-in window opens inside Flora. You need an account that owns Minecraft: Java Edition. You can add more than one account and switch between them from the top bar.

  3. Create an instance

    Choose New instance. Pick a Minecraft version and a mod loader, or start from a Modrinth or partnered modpack.

  4. Press Play

    The first launch of a version downloads its game files and the Java it needs, so it takes longer than later launches. Progress shows on the Home page, and the Console page shows the game’s output.

Installing from the offline package

The offline package is a .tar.gz archive of the Flora Client application. Your accounts and instances are stored in the data folder for your system, not in the folder you extracted to. The offline package adds no shortcuts or uninstall entry.

Windows

mkdir Flora
tar -xzf .\flora-0.6.0.tar.gz -C .\Flora
.\Flora\FloraClient.exe

Windows 10 and 11 include tar. Your data is in %APPDATA%\FloraClient.

macOS

mkdir -p Flora && tar -xzf flora-0.6.0-macos.tar.gz -C Flora
open Flora/FloraClient.app

The first launch of an unsigned copy needs right-click, then Open. Your data is in ~/Library/Application Support/FloraClient.

Linux

mkdir -p Flora && tar -xzf flora-0.6.0-linux.tar.gz -C Flora
./Flora/FloraClient

Install WebKitGTK 4.1 (for example libwebkit2gtk-4.1-0) for the sign-in window. Your data is in $XDG_DATA_HOME/FloraClient, which defaults to ~/.local/share/FloraClient.

To update, extract a newer package over the folder, or upgrade through Homebrew. Version 0.6.0 is the current release.

Uninstalling

Windows

If you used the online installer, open Windows Settings, then Apps, find Flora Client and choose Uninstall. Flora keeps your accounts, instances and worlds unless you tick the checkbox to delete your data.

Homebrew

On a Mac, run brew uninstall --cask flora-client. On Linux, run brew uninstall flora-client. Your data folder stays where it is. Delete it yourself if you want your accounts, instances and worlds gone too.

Offline package

Delete the folder you extracted it to. Your data folder stays where it is, as above.

Frequently asked questions

Do I need to own Minecraft?

Yes. You sign in with a Microsoft account that has Minecraft: Java Edition (Game Pass accounts with Java Edition work too). Flora has no offline or cracked mode.

Which platforms does Flora run on?

Windows 64-bit, macOS and 64-bit x86 Linux. macOS and Linux install through Homebrew or the offline package. Linux needs WebKitGTK 4.1 for the sign-in window.

Which Minecraft versions can I play?

Releases and snapshots, including the newer year-based version numbers. Versions older than 1.7 are not supported. Forge is available for 1.13 and newer; NeoForge for 1.20.2 and newer. Fabric and Quilt follow what their own services offer.

Can I sign in with GitHub or another provider?

No. Sign-in runs in an embedded browser limited to Microsoft’s sign-in domains. Use a Microsoft password, passkey or one-time code.

Where does Flora keep my data?

In the FloraClient folder of your system: %APPDATA%\FloraClient on Windows, ~/Library/Application Support/FloraClient on macOS and $XDG_DATA_HOME/FloraClient (default ~/.local/share/FloraClient) on Linux. It holds accounts, instances, settings, shared game files and logs. Logs mask tokens and sign-in codes before they are written.

Will uninstalling delete my worlds?

Not by default. On Windows the uninstaller removes the app, shortcuts and its registry entry, and keeps everything else in %APPDATA%\FloraClient. Deleting your data is a separate checkbox you have to tick. Homebrew and the offline package also leave your data folder in place.

How do I update Flora?

On Windows, run the newer online installer. When Flora is already installed it offers Update, and it keeps your data and any changes you made to appsettings.json. With Homebrew, run brew upgrade. With the offline package, extract the newer one over the folder.

Does closing Flora close my game?

No. Closing the launcher cancels installs that are still running, but a game that is already running keeps running until you quit it.

Why does the download use http instead of https?

Flora’s download server does not support HTTPS at the moment. The online installer checks the package against a SHA-256 checksum before installing it, and you can check the offline package yourself with the checksum on the download page.

Is my Minecraft access token safe?

Flora saves only the refresh token, encrypted with a key held by your system: Windows DPAPI on Windows, the Keychain on macOS, and a key file that only your user can read on Linux. It keeps the access token in memory. Like the official launcher, it passes the access token to the game on the Java command line, so other programs running as your user can see it while the game runs.

Something went wrong. Where do I look?

Open the Console page in Flora for live output. Logs are in the logs folder of your data folder (%APPDATA%\FloraClient\logs on Windows). On Windows, a failed start also leaves logs\startup-crash.log.