Personal tools
User menu

Installation MacOS

From Ancestris Free Genealogy Program

Jump to: navigation, search

If necessary, this page will detail set-by-step how to install Ancestris on a MacOS system. The sections below are independant and do not all need to be done.


Installation of version 0.9

  1. Follow the instructions below from your MacOS environment.

09 01.png

  1. Go to, click on 'Download' in the Menu, and click on 'MacOS' to start downloading.

09 02.png

  1. Downloading takes 1 to 2 minutes.

09 03.png

  1. Once done, you will see an ancestris file with size of 52.4 MB. The Ancestris icon will appear in the right-hand side of the Dock.

09 04.png

  1. Click on the Ancestris icon.

09 05.png

  1. A message will appear indicating that 'ancestris' cannot be opened because it comes from an unidentified developer.

09 06.png

  1. No problem, we will tell your system that it can be authorized. We start to open the 'System Preferences' in the 'Apple' menu.

09 07.png

  1. Then choose 'Security and Privacy'.

09 08.png

  1. In the 'Security and Privacy' window, click on "Open anyway'.

09 09.png

  1. Click 'Open" to confirm.

09 10.png

  1. Confirm again with your password.

09 11.png

  1. Ancestris then starts.

09 12.png

  1. Ancestris then displays the Welcome screen. Your are now ready to use Ancestris.

09 13.png

  1. If you want to keep Ancestris in your Dock, right-click on the Ancestris icon in the Dock and choose "Keep in Dock".

09 14.png

Installation of the daily version

  1. Follow the instructions below from your MacOS environment.

Vq 01.png

  1. Go to, click on 'Download' in the Menu, and then, in the Daily version panel, click on 'Download' to start downloading.

Vq 02.png

  1. Downloading takes 2 to 3 minutes.

Vq 03.png

  1. Once done, you will see an ancestris file with size around 77 MB.

Vq 04.png

  1. In the Download window, click on the file location to open the Finder.

Vq 05.png

  1. The download directory will appear. Select the bin directory, then the 'ancestris' file.

Vq 06.png

  1. A message appears asking your confirmation to open 'ancestris". Click 'Open' (if you get the same message as described in the 0.9 version installation section, please follow the corresponding steps.).

Vq 07.png

  1. Ancestris then starts.

Vq 08.png

Docking Ancestris in the Launchpad

The following steps correspond to installing the daily version of Ancestris.

  1. Select the ancestris.gif file located in the directory where you downloaded Ancestris, right-click on it, then select 'Open with', then 'Preview'. This will open the ancestris.gif image.

Dock 01.png

  1. In the image preview, select all.

Dock 02.png

  1. In the image preview, copy the image, and close the image window.

Dock 03.png

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

Dock 04.png

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

Dock 05.png

  1. The information window appears.

Dock 06.png

  1. Select the icon in the top-left corner. A blue border should appear.

Dock 07.png

  1. Click 'Paste' from the menu to replace the image icon by the previously copied image.

Dock 08.png

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

Dock 09.png

  1. Ancestris is now set in the Dock. Run Ancestris by clicking on it.

Dock 10.png

  1. Ancestris starts.

Dock 11.png

  1. The Welcome screens then appears. You are now ready to use Ancetris.

Dock 12.png

Knowing which Java version you use

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

  1. Open 'System Preferences' in the 'Apple' menu.

Java 01.png

  1. 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

  1. The 'About Java' popup window appears, indicating which version of java is running on your system. Here we can see it is version 1.8.

Java 03.png

Swap between different Java versions

If your version of Java running on your system is higher than 1.8, Ancestris 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 Java version 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, instructions let you set version 1.8 by default, without removing Java version 10:

  1. Check which version of java is set by default:

java -version
echo $jdkhome

Swap 02.png

We can see version 10. It is not good. You need version 1.8 for Ancestris. Follow the steps below.

  1. Get the list of all installed versions on your system and check that version 1.8 is among them.:

/usr/libexec/java_home -V

Swap 03.png

OK, we can see version 1.8 is installed. It it were not, install it from this page.

  1. Type in the following 2 lines in the Terminal. It will add the command to set your default Java version in your personal profile:

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

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).

  1. Close the Terminal:


  1. Reopen a Terminal and check now that the running version of Java is 1.8:

java -version
echo $jdkhome

Swap 05.png

OK, it is. We can see version 1.8. You can now start Ancestris.

  1. 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 1.8 of Java is being used by Ancestris.

  • This page was last modified on 13 June 2018, at 20:36.
  • This page has been accessed 477 times.