Skip to main content

Step-by-step installation on MacOS

This page documents a detailed step-by-step installation of Ancestris on a MacOS system.

We will show an example that occurred on January 2021, of the installation of Ancestris version 11 on MacOS Catalina.

Since then, both the stable and daily versions of Ancestris can now be installed by just downloading and clicking on the MacOS package. Therefore all the details below are only useful in case you need to install a ZIP package rather than a MacOS package.

macOS-01.png

These steps include the following:

Please note that the screenshots shown here might look different from those of the current Ancestris web site or the current Ancestris software version.

Special note for users of MacOS Big Sur: please follow the steps below and then, please do read this specific section at the bottom of this page.


Installation of Java

1. From the MacOS desktop...

macOS-02.png


2. Open a terminal and type "java -version"

If Java is not installed, a popup window will suggest to install it. Click "More Info...".

If java is installed, you can directly go to screen 11.

macOS-03.png


3. You are on the Java web site. Click on "JDK Download"

We can see from the web site that Java 15 was suggested. Let us install that version even though we recommend to use version 8 or 11 which are long terme versions (see required configuration).

macOS-04.png


4. Go down to the "macOS Installer" line and click on the ".dmg' file
en-macOS-05.png


5. Click on the green download button.
macOS-06.png


6. Downloading starts... Wait.
macOS-07.png


7. Downloading is completed. Open the Downloads folder to check out the file.
macOS-08.png


8. Double click on the JDK package.

macOS-09.png


9. The JDK installer starts. Just follow the steps.

en-macOS-10.png


10. The installation should be successful. Close the window.

macOS-11.png


11. Then type again "java -version" in the terminal.

The following result should appear, indicating Java 15 is installed in our example.

macOS-12.png

Your are now done with the Java installation. Let's install Ancestris now.


Installation of Ancestris

12. Go to the https://www.ancestris.org web site

macOS-13.png


13. In the menu, click on DOWNLOAD. This will scroll down to the download section.

macOS-14.png


14. Click on the Ancestris 11 button of the MacOS panel.

en-macOS-15.png


15. Allow downloads from the Ancestris web site if this is the first time you do it.

macOS-16.png


16. Downloading starts. It will take a couple of minutes.

macOS-17.png


17. Wait a bit more ... we said a couple of minutes !

macOS-18.png


18. Once complete, move the file to your genealogy folder.

macOS-19.png

If you have downloaded the stable version of Ancestris, just click on the Ancestris package and it will install itself in the /Applications folder. Then skip to step 29.

Steps 19 to 28 are for the daily version of Ancestris only, which does not included in a package.

19. It is better to place your Ancestris application in a separate folder from your genealogy files.
  • You may for instance place Ancestris in a Documents/Genealogy folder.
  • And you may place later your genealogy data in a folder such as {Home}/Public/Genealogy Files/

Do not place your genealogy files in the Documents, Desktop or Downloads folders, or underneath them. MacOS will not let you see them from Ancestris as a security check for non-signed application like Ancestris.

en-macOS-20.png


20. To make sure it is the version you expect, click on "Quick Look "Ancestris" from the context menu.

macOS-21.png


21. The application panel should tell you about the file version and date.

macOS-22.png


22. Click 'Open ancestris' or go back top your Genealogy folder and click on the icon to launch Ancestris.

macOS-23.png



Confirmation of the security check

23. Ancestris starts but MacOS tells you it comes from an unverified developer. Not a problem. Ancestris is open source and does not have any malware. Let's authorize it.

macOS-24.png


24. For that, go to the System Preferences

en-macOS-25.png


25. Click on "Security & Privacy"

macOS-26.png


26. Click on "Open anyway"

macOS-27.png


27. If it is the first time you do this, confirm with your password.

macOS-28.png


28. Yes, you are sure. Click "Open".

macOS-29.png


29. Finally, Ancestris starts.

en-macOS-30.png


30. You can see the Welcome window.

macOS-31.png


31. Please note that from the application Menu, you can access the Preferences and the "About Ancestris" panel.

macOS-32.png


Keep in dock

32. Let's keep the application in the Dock by clicking on the Ancestris icon in the dock panel.

macOS-33.png


33. Choose "Option" and "Keep in Dock".

macOS-34.png


34. This is it. Ancestris is installed and in the Dock. Yessss !

en-macOS-35.png





Special note for users of MacOS Big Sur


en-Ancestris-MacOS-BigSur11-4.png

Since July 2021, the stable version installs itself in the /Applications folder so from step 19 above, all you have to do is to click on the installation package. The steps from step 19 are only necessary for version 12.

For version 12, there are additional steps for MacOS Big Sur users, in case Ancestris does not start after the installation above:

  • It might be necessary to store Gedcom files in another folder than the 'Documents', 'Desktop' and 'Downloads' folders. For instance, you can use the "Public" folder.
    • Indeed, for security reasons, MacOS might prevent access to these folders by non-signed applications.
    • It can also happen that an error message "Wrong line n° null" is displayed when opening a Gedcom file that is placed under one of these folders.


  • It might be also necessary to specify the path to the java version in the ancestris configuration file. This is explained below.

Please follow these additional steps to specify the path to the java version in the ancestris configuration file:

Basic principles:
  • The configuration file is here : ${HOME}/Library/Application Support/ancestris/trunk/etc/ancestris.conf
  • Java's location is given by the following line command : /usr/libexec/java_home -V

These are the steps.

1. Open a terminal, and check and copy the location of the installed java version
  • Type /usr/libexec/java_home -V on the command line and press Enter
  • You should see the path of the installed java version.
  • Select the line indicating the path, and click on the mouse to copy it in the clipboard. This line could be different in your case.
    • Here it is /Library/Java/JavaVirtualMachines/jdk-15.0.1.jdk/Contents/Home

en-force-java-path-01.png

2. Open the editor on the Ancestris configuration file
  • Type the following command:  nano ${HOME}/Library/'Application Support'/ancestris/trunk/etc/ancestris.conf

en-force-java-path-02.png

3. The nano editor opens and shows the content of the Ancestris configuration file

en-force-java-path-03.png

4. Add - or modify - the line that says jdkhome="" and paste the java path between the double quotes
  • Add the line if it does not exist
  • Or update it otherwise. Make sure in this case that there is no pond sign "#" at the beginning of the line, your change would not be taken into account.

en-force-java-path-04.png

5. Exit and save your change

en-force-java-path-05.png

6. Check that the Ancestris configuration file has your change, and start Ancestris.
  • Type the command starting with "cat ${home}/..." below.
  • The terminal displays the configuration file with the added line.

en-force-java-path-06.png

The configuration file is updated. You can start Ancestris and Ancestris should find java.