Skip to main content

Install and start Ancestris

Read license and user rights

Ancestris is free software, licensed under the  GNU GENERAL PUBLIC LICENSE V3.

Ancestris is a free genealogy program, for unlimited time usage, and an unlimited number of individuals.

It is made available to you by volunteers.


Check our required configuration

Ancestris works on all latest MacOS, Windows and Linux platforms running Java.

If Ancestris does not start, or shows the Ancestris splash screen and stops, it is most generally related to an issue with the Java installation.

To use Ancestris, it is required to have the following configuration:

  • Java version 8 to 21.
  • We can only support Java LTS versions of java even though Ancestris seems to properly work with other intermediary versions.
  • 2 Gb RAM
  • 200 Mb of available disk space
  • A big enough screen, 1920 x 1080 minimum recommended

Java is a prerequisite

To use Ancestris, you need to have Java installed on your system.

Ancestris is compatible and has been tested with the version listed above.

To identify which Java version is installed on your system, other Java versions available, how to swap between Java versions, or the Java technical requirements, check out the Java installation page.

Note to MacOS users

Ancestris comes with a native MacOS launcher which requires MacOS version 10.14.4 at a minimum.

If you cannot upgrade your MacOS version to this level, you will need to launch Ancestris manually from the Ancestris script itself located here: /Applications/Ancestris.app/Contents/Resources/ancestris/bin/ancestris

If you use the manual way of launching Ancestris, you will not be able to write nor read files located underneath the Documents, Desktop and Downloads folders as per Apple security restrictions even though Ancestris is signed and notarized using the Apple platform. As an alternative, you will be able to store your files under /Public.

Installation

If you need detailed installation steps, we provide you with a step-by-step guide corresponding to your system :
Step-by-step installation guide for MacOS
Step-by-step installation guide of stable version 11 for Windows
Step-by-step installation guide of daily version 12 for Windows

What follows is the general overview of the installation and the links in case of troubles or to change launch settings.


Go to Download on the Ancestris site

Ancestris can be downloaded for free on our page  https://www.ancestris.org via the DOWNLOAD option.

en_Ancestris_website.png


Choose your Ancestris version

Two versions are available.


All versions work on any device under any operating system that can use Java.

All versions work with all existing translations.

All versions are full versions and allow unlimited usage.


Download Ancestris

This shows the Download section of the Ancestris site.

en-download-ancestris.png

  • Click on the Ancestris version button of your operating system
    • MacOS. It will download a pkg file.
    • Windows. It will download an exe or zip file depending on the Ancestris version.
    • Linux. Hovering over Ancestris 11 or Ancestris 12, a menu will appear where you can pick the AppImage file or a ZIP file.
  • The downloaded file will be specific to the operating system you choose
  • Follow the steps suggested by your Internet browser and save the file
  • The download will take a few minutes and will result in a file of about 139 Mb.

This is an example with Ancestris 11 for Windows.

en-version11.png

This is an example with Ancestris 12 for Windows or for Linux.

en-version-trunk.png


Choose Ancestris folder

At the end of the download, the file will be placed in your default download folder.

If you don't know what this folder is, check your Internet browser's settings or else click on the downloaded icon of your browser.

From that folder, feel free to move the downloaded file wherever you want on your computer. The software platform used by Ancestris is Netbeans. Therefore, accents in the installation path are prohibited. On MacOS, the stable version is installed by default in /Applications.


Start Ancestris

The way to start Ancestris  slightly differs depending on the OS system you have.

Ancestris's files will be inside the resulting ancestris folder. Refer to the Software files page to have the detailed view of the  ancestris folder.

To start Ancestris, run the downloaded file or else run the executable in the bin folder that corresponds to the operating system you are using.

  • MacOS : click on the package file and Ancestris will install itself in the Applications folder, from which you can start Ancestris.
  • Windows : for version 11, just double-click on the downloaded exe file Ancestris11Setup.exe. This installation programme will assist you in the installation of Ancestris and it will also create the launcher icon. For version 12, run the ancestris64.exe file in the bin folder.
  • Linux : click on the AppImage file or unzip the archive and then double-click on the 'ancestris' file of the bin folder.

Regardless of the version, here is what you will see when Ancestris is started.

en-Ancestris.png


Troubleshooting

If you need detailed installation steps, please read the step-by-step guide below corresponding to your system :
Step-by-step installation guide for MacOS
Step-by-step installation guide of stable version 11 for Windows
Step-by-step installation guide of daily version 12 for Windows

If Ancestris does not start, or shows the Ancestris splash screen and stops, it is most generally related to an issue with the Java installation.
Either Java is not installed or Ancestris does not find it or finds an incompatible version or finds a corrupted version.
Please check the Java installation page for help.


Personalisation

Shortcut icon

If you need to customize a shortcut with a nice icon to start Ancestris, please check your operating system's documentation on how to create it, and feel free to use the included image file ancestris.gif provided within the softwares files.
For MacOS, see the step-by-step guide.
For Windows, see the step-by-step guide.
For Linux, there are several of these procedures, and quite different from one system to another.

Launch settings

You can personalise the way Ancestris starts such as the memory allocation for instance. In case you need to personalise the way Ancestris is launched, please refer to the Launch settings page.

User settings

If you are interested in knowing where the user settings files are, please refer to the Software and user settings files page.