# Installation instructions

## On Windows (64 bit)

Installing Ludo on Windows should be easy.

1. Download the latest stable release from our web site <https://ludo.libretro.com/> or from Github <https://github.com/libretro/ludo/releases>
2. Unzip the archive somewhere on your hard drive
3. Create a shortcut for ludo.exe if needed
4. Launch `ludo.exe`

{% hint style="warning" %}
On first launch, Windows will ask you if you really want to launch an executable you downloaded from Internet. Just click Open Anyway.
{% endhint %}

{% hint style="warning" %}
Portable mode on USB drives is not supported. Ludo will create files on under your main user directory in Windows.
{% endhint %}

Updating Ludo requires redoing all the steps above.

## On Mac OS X (64 bit)

Installing Ludo on Mac OS X is also easy.

1. Download the latest stable release from our web site <https://ludo.libretro.com/> or from Github <https://github.com/libretro/ludo/releases>
2. Open the `.dmg` file
3. Drag Ludo.app in your Applications folder
4. Find Ludo in your Applications and launch it

{% hint style="warning" %}
On first launch, OSX will ask you if you really want to open an app from internet, just click Open Anyway.
{% endhint %}

Updating Ludo require redoing all the steps above.

## On Linux for 64bit PC

There are many ways to install Ludo on Linux, depending on the Linux distribution and the preferred method.

### From the tarballs

1. Download the latest stable release from our web site <https://ludo.libretro.com/> or from Github <https://github.com/libretro/ludo/releases>
2. Uncompress the `.tar.gz` somewhere
3. Double click on `ludo`

If Ludo doesn't launch, you might need to install the OpenAL library on your Linux.

Updating Ludo requires redoing all the steps above.

### Using distribution package managers

Third party contributors maintain packages of Ludo for the major Linux distributions. These package managers will install all the required dependencies for you and take care of updates.

On Arch Linux or derivatives, use the AUR packages:

* <https://aur.archlinux.org/packages/ludo-bin>
* <https://aur.archlinux.org/packages/ludo/>

On Debian, Raspbian or Ubuntu, use the `.deb` packages from the latest Github release:

* <https://github.com/libretro/ludo/releases>

### Using snap

You can use the snap package here <https://snapcraft.io/ludo>

### Using flatpak

There is a flatpak repository here, but the package doesn't seem published yet <https://github.com/pdureau/flatpak-manifests>

## On Raspberry Pi

This section assume you are using Raspbian.

1. Enable the experimental VC4 OpenGL support (Full KMS) in raspi-config.
2. Reboot
3. Download the latest stable release from our web site <https://ludo.libretro.com/> or from Github <https://github.com/libretro/ludo/releases>
4. Uncompress the `.tar.gz` somewhere
5. Double click on `ludo`

If Ludo doesn't launch, you might need to install the OpenAL library on your Linux.

Updating Ludo requires redoing all the steps above.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://jean-andre-santoni.gitbook.io/ludo/installation-instructions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.