# Installation (/editor/installation)



Get LVGL Pro Editor running on your system with installation steps tailored to your operating system.

Windows [#windows]

Install WSL [#install-wsl]

The Editor requires **Windows Subsystem for Linux** (WSL) to run on Windows.

First, check if WSL is already installed by opening a Terminal and running:

```bash title="bash" lineNumbers=1
wsl.exe --list --verbose
```

If WSL is not installed, run:

```bash title="bash" lineNumbers=1
wsl --install
```

Then press Enter and wait for the installation to complete.

Install the Editor [#install-the-editor]

1. Go to [pro.lvgl.io/#download](https://pro.lvgl.io/#download)
2. Click the **Download** button
3. Save the installer to your computer
4. Run the installer and follow the prompts to complete the installation

Linux [#linux]

Install Podman [#install-podman]

The Editor compiles and runs C code in containers using **Podman** (similar to Docker). Install Podman for your Linux distribution:

* **Debian, Ubuntu, Linux Mint**: `sudo apt-get install podman`
* **Fedora**: `sudo dnf -y install podman`
* **Arch, Manjaro Linux**: `sudo pacman -S podman`

For other distributions, see the [Podman installation guide](https://podman.io/docs/installation#installing-on-linux).

Install the Editor [#install-the-editor-1]

1. Download the AppImage from [pro.lvgl.io/#download](https://pro.lvgl.io/#download)
2. Make it executable:
   ```bash title="bash" lineNumbers=1
   chmod +x LVGL_Pro_Editor.AppImage
   ```
3. Run the application:
   ```bash title="bash" lineNumbers=1
   ./LVGL_Pro_Editor.AppImage
   ```

Troubleshooting [#troubleshooting]

**Issue:** Double-clicking the `.AppImage` file doesn't launch the application, or you see a GTK error:

```bash title="bash" lineNumbers=1
(process:3943): Gtk-ERROR **: 11:45:01.301: GTK 2/3 symbols detected.
Using GTK 2/3 and GTK 4 in the same process is not supported
Trace/breakpoint trap (core dumped)
```

**Solution:** Run the AppImage from the terminal with the GTK version specified:

```bash title="bash" lineNumbers=1
./LVGL_Pro_Editor.AppImage --gtk-version=3
```

MacOS [#macos]

Install Podman [#install-podman-1]

The Editor compiles and runs C code in containers using **Podman** (similar to Docker). Install it using Homebrew:

```bash title="bash" lineNumbers=1
brew install podman
```

For more information, see the [Podman installation guide for macOS](https://podman.io/docs/installation#macos).

Install the Editor [#install-the-editor-2]

1. Download the appropriate version from [pro.lvgl.io/#download](https://pro.lvgl.io/#download):
   * **ARM** for Apple Silicon (M1/M2/M3)
   * **AMD** for Intel-based Macs
2. Drag the application to your **Applications** folder in Finder
3. Launch the Editor from Applications or Spotlight
