Skip to main content

Step-by-step installation on MacOS (STL)

This page shows step-by-step how to install Ancestris on a MacOS system.

The sections below are independent and do not all need to be done.

Screens shown might look different from those of the current Ancestris web site or the current Ancestris software version.

Knowing which Java version you use

These steps let you identify which version of Java is running on your system.

1/3 - Open 'System Preferences' in the 'Apple' menu.


Java 01.png


2/3 - Find the 'Java' application in the list and click on it. If it is not in the list, it means Java is not installed on your system.


Java 02.png


3/3 - The 'About Java' popup window appears, indicating which version of java is running on your system. Here we can see it is Version 8 (aka 1.8).


Java 03.png


Install Ancestris version 10 or 11

1/9 - Follow the instructions below from your MacOS environment.


Vq 01.png

2/9 - Download either version of Ancestris.
  • Go to, click on 'DOWNLOAD' in the Menu
  • Then click on 'MacOS' to download version 10
  • Or scroll down to the Daily version panel and click on the 'DOWNLOAD' button for version 11
  • Then downloading will start.

Vq 02.png


3/9 - Downloading takes 2 to 3 minutes.


Vq 03.png


4/9 -Once done, you will see an 'ancestris' file with size indicated on the right-hand side.


Vq 04.png


5/9 - In the 'Downloads' window, click on the 'ancestris' file location to open the Finder.


Vq 05.png

6/9 - Start Ancestris.
  • The 'Downloads' directory will appear.
  • For version 10, just click the 'ancestris' main folder as it is already unpacked for MacOS and it will start Ancestris.
  • For daily version 11, you will have to select the 'bin' directory, then click the 'ancestris' file.


Vq 06.png

7/9 - Confirmation to launch.
  • A message appears asking your confirmation to open 'ancestris'. Click 'Open'.
  • If you also get another a message that 'ancestris' cannot be opened because it is from an unidentified developer, please follow these steps.

Vq 07.png


8/9 - Ancestris then starts.


Vq 08.png


9/9 - The Welcome screens then appears. You are now ready to use Ancestris.


Dock 12.png


If you downloaded the daily version, you might want to create an Ancestris icon in the launchpad. In which case please follow the corresponding instructions.

If Ancestris does not start, it might be related to a java version issue. You may have to swap the Java version.
Please follow these instructions.


Ancestris from an unidentified developer

1/8 - Message "Ancestris can't be opened".

When opening the downloaded 'ancestris' file, a message may appear saying that 'ancestris' cannot be opened because it is from an unidentified developer.

09 06.png


2/8 - It's okay, we will tell your system that it can be authorized.
  • We start by opening the 'System Preferences' in the 'Apple' menu.

09 07.png


3/8 - Then choose 'Security and Privacy'.


09 08.png


4/8 - In the 'Security and Privacy' window, click on 'Open anyway'.


09 09.png


5/8 - Click 'Open' to confirm.


09 10.png


6/8 - Confirm again with your password.


09 11.png


7/8 - Ancestris then starts.


Vq 08.png


8/8 - The Welcome screens then appears. You are now ready to use Ancestris.

Dock 12.png


Docking Ancestris in the Launchpad

The following steps apply to the daily version of Ancestris.

1/12 - Select the 'ancestris.gif' file
  • It is located in the directory where you downloaded Ancestris
  • Right-click on it
  • Then select 'Open with'
  • Then click 'Preview' to open the 'ancestris.gif' image

Dock 01.png


2/12 - In the image preview, select all.


Dock 02.png


3/12 - In the image preview, copy the image, and close the image window.


Dock 03.png


4/12 - Go back to the download window, and right-click on the 'ancestris' file. Select 'Make alias'.


Dock 04.png


5/12 - Once the alias is created, right-click on it and select 'Get Info'.


Dock 05.png


6/12 - The information window appears.


Dock 06.png


7/12 - Select the icon in the top-left corner. A blue border should appear.


Dock 07.png


8/12 - Click 'Paste' from the menu to replace the image icon by the previously copied image.


Dock 08.png


9/12 - The alias file has now the correct image. Drag-n-Drop it on the Dock.


Dock 09.png


10/12 - Ancestris is now set in the Dock. Run Ancestris by clicking on it.


Dock 10.png


11/12 - Ancestris starts.


Dock 11.png


12/12 - The Welcome screens then appears. You are now ready to use Ancestris.


Dock 12.png