# Step-by-step installation on Linux

## Installation with AppImage 

##### Download the AppImage file from Ancestris web site hovering the mouse on the Ancestris Stable or Ancestris Daily button

[![en-install-download-linux.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/en-install-download-linux.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/en-install-download-linux.png)

##### Go to the directory where the file was downloaded and move it to a directory where you want to store the Ancestris program

[![Linux2.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/linux2.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/linux2.png)

##### Make sure the file is executable by right clicking on it and choosing Properties

[![Linux3.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/linux3.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/linux3.png)

##### Make the file executable

[![Linux4.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/linux4.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/linux4.png)

##### Double click on it. A menu appears if you install this file for the first time. Choose either to lanch Ancestris or to Install it in the Launch bar.

[![Linux6.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/8T9linux6.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/8T9linux6.png)

##### An 'Ancestris' menu button appears in the launch bar and Ancestris is launched.

If the Ancestris launcher was already present in the launch bar, the launcher will be replaced.

[![Linux5.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/linux5.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/linux5.png)

## Installation with the ZIP file

- Dowload the ZIP file from the website similarly to the the situation described above
- Move the file to the directory of your choice
- Unzip the file
- Install a launcher: this is a .desktop file in a directory similar to ~/.local/share/applications that look like this:

```
[Desktop Entry]
Type=Application
Name=Ancestris
Icon=ancestris.png
Exec="~/<directory path to ancestris>/ancestris/bin/ancestris" %U
Categories=Office;Utility;
```

- Run nancestris either using this launcher or by clicking ion the 'bin/ancestris' script

<p class="callout info">As you may have noticed, using the AppImage file is much simpler and using the ZIP file should only be used to personlize the launcher or have several Ancestris version on your computer.</p>

## Uninstallation

### If you installed via AppImage

Right clic on the Ancestris launcher and choose Remove Ancestris.

[![Linux7.png](https://docs.ancestris.org/uploads/images/gallery/2025-11/scaled-1680-/linux7.png)](https://docs.ancestris.org/uploads/images/gallery/2025-11/linux7.png)

### If you installed by unpacking the ZIP file

Just delete the ancestris folder.

## Troubleshooting

If double-clicking on the AppImage file does not launch it, run it manually from a Terminal window.

```
$ ./Ancestris13.AppImage
```

The response should help you identify the problem.

Possible causes:

- File is not executable
- libfuse2 library is missing