> For the complete documentation index, see [llms.txt](https://manual.xlights.org/xlights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.xlights.org/xlights/chapters/chapter-three-installation/linux.md).

# Linux

## Downloading xLights

The latest AppImage release of xLights for Linux can be found at the following link:

<https://github.com/xLightsSequencer/xLights/releases>

You can also download the source from <https://github.com/xLightsSequencer/xLights> and compile as per the included README.linux file.

## Installing xLights

#### AppImage Builds

1. Appimage builds are created with Ubuntu 22.04.
   1. Debian and Gnome based distribution are recommended for best compatibility.
2. Download the latest "xLights-20xx.xx-x86\_64.AppImage" file from:
   1. <https://github.com/xLightsSequencer/xLights/releases>
3. Set the AppImage file as an executable (for example ‘chmod +x ./xLights-xxxx.xx-x86\_64.AppImage’) and then run the file directly.