Title: Installation
Description: Install the GhostESP companion app on your Flipper Zero device
URL: /latest/flipper-app/installation/
Version: latest
Section: Flipper Zero App
Keywords: install, setup, app catalog, fap
Search index: /search-index.json

# Installation

> Install the GhostESP companion app on your Flipper Zero device

## On this page

- [Prerequisites](#prerequisites)
- [Method 1: Flipper App Catalog (Recommended)](#method-1-flipper-app-catalog-recommended)
- [Method 2: Manual Installation](#method-2-manual-installation)
- [Version Compatibility](#version-compatibility)

---

## Prerequisites
- Flipper Zero device
- GhostESP firmware flashed on an ESP32 device
- Latest version of the companion app (.fap file)
## Method 1: Flipper App Catalog (Recommended)
- Connect your Flipper Zero to your computer (or pair it with the Flipper Mobile App) and open the [Flipper app catalog](https://lab.flipper.net/apps/ghost_esp) in a browser
- Search for “Ghost ESP” and open the entry (category: GPIO)
- Click Install - the app is uploaded to your Flipper Zero automatically
- Launch it from Applications → GPIO on your Flipper Zero
## Method 2: Manual Installation
-
Download the latest release
Visit the [releases page](https://github.com/GhostESP-Revival/GhostESP-FlipperCompanion/releases/latest)
- Download the .fap file for your Flipper Zero firmware version
-
Transfer to Flipper Zero
Use qFlipper (desktop or mobile app) to transfer the file
- Or copy the .fap file directly to your Flipper’s SD card under apps/ directory
-
Launch the app
Navigate to Applications → GhostESP on your Flipper Zero
- The app will start and attempt to connect to your GhostESP device
## Version Compatibility
The companion app is regularly updated to support new GhostESP firmware features. Always use the latest version of both:
- GhostESP Firmware: Latest release from main repository
- Companion App: Latest .fap from [releases](https://github.com/GhostESP-Revival/GhostESP-FlipperCompanion/releases)
Note: Older app versions may not support newer firmware features. Check the [changelog](https://github.com/GhostESP-Revival/GhostESP-FlipperCompanion/blob/main/CHANGELOG.md) for compatibility information.
After installing the app, proceed to [Connection Setup](/latest/flipper-app/connection/) to configure the serial connection between your Flipper Zero and GhostESP device.