Skip to main content

Step-by-step installation on MacOS (STLM)

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 prerequisite Java version

Ancestris requires Java to be installed.

Install Java Version 8 (aka 1.8)

Java Version 8 is recommended as it supports all Ancestris features.

Download and install Java 8 (aka 1.8).

For full details see JRE 8 Installation for OS X.

Install Java Version 11

Later versions up to Java Version 11 support most Ancestris features.

Download and install Java Development Kit (JDK) Version 11 macOS .dmg file.

The installation of JDK Version 11 requires macOS 10.11 or later.

For full details see Installation of the JDK on macOS.

 

 

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 https://www.ancestris.org, click on 'DOWNLOAD' in the Menu
  • Then click on 'MacOS' for 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 pacaked 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

 

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

In case Ancestris does not start, it might be related to a java version issue. You may have to swap 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 to open 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

 

Swap between different Java versions

The version of Java running on your system may be incompatible with Ancestris, so it will not run. You will get a message like the following in a terminal when Ancestris starts:

Swap 01.png

If you want to keep your current Java version and run say Java Version 8 (aka 1.8) at the same time, you need to swap Java versions.

To swap between different Java versions, open a Terminal window and follow the steps below.

In the following example, the instructions let you set Version 8 (aka 1.8) by default, without removing Java Version 10:

1/6 - Check which version of Java is set by default
java -version
echo $jdkhome

Swap 02.png

We can see Version 10. If you need Version 8 (aka 1.8) for Ancestris, follow the steps below.

2/6 - Get a list of all installed versions on your system and check Version 8 (aka 1.8) is among them
/usr/libexec/java_home -V

Swap 03.png

OK, we can see Version 8 (aka 1.8) is installed.
If it were not, then install it as explained on this page.

3/6 - Type in the following 2 lines in the Terminal
echo 'export JAVA_HOME=`/usr/libexec/java_home -v 1.8`' >>~/.bash_profile
echo 'export jdkhome==`/usr/libexec/java_home -v 1.8`' >>~/.bash_profile

These two lines will add the command to set your default Java version in your personal profile.

Swap 04.png

The first line defines the default Java version for all programs (JAVA_HOME, in uppercase).

The second line defines the default Java version to use for Ancestris (jdkhome, lowercase).

4/6 - Close the Terminal
exit
5/6 - Reopen a Terminal and check that the running Java is Version 8 (aka 1.8)
java -version
echo $jdkhome

Swap 05.png

OK, it is. We can see Version 8 (aka 1.8). You can now start Ancestris.

6/6 - Start Ancestris

Swap 06.png

When Ancestris starts, a Terminal window opens at the same time.

You can see in the title bar that Version 8 (aka 1.8) of Java is being used by Ancestris.