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 March 2024, of the installation of Ancestris version 12 on MacOS Sonoma.

A-Intro-01.png

Installation of Java

1. From the MacOS desktop...

A-Intro-02.jpg


2. Open a terminal and type "java -version" to check if Java is already installed or not.

B-JAVA-02.png

If Java is not installed, the response will indicate that Java cannot be located.
So install it by following these next steps.

B-JAVA-03.png

If java is installed, the response will indicate that Java is found and provide the version number. Here version 17 is installed.
In this case, all good, jump to step 5 to install Ancestris.

B-JAVA-04.png


3. Install Java by going to the Adoptium web site.

Here Adoptium suggests to install the LTS (Long Term Support) release Java 21 for MacOS.

B-JAVA-05.png


Click the "Latest LTS Release"  button. You should see this page now.

Note: If you want to install another version, click the button "Other platforms and versions".

B-JAVA-06.png

Downloading has started... Click the download round button on your browser and wait.

B-JAVA-07.png

After a short moment, downloading is completed. 

B-JAVA-08.png

Launch the JDK package from this download popup. You should see this installation window.

B-JAVA-10.png

Click Continue.

B-JAVA-11.png

Click Continue.

B-JAVA-12.png

Click Agree.

B-JAVA-13.png

Click Install.

B-JAVA-14.png

Validate with your fingerprint or enter your Mac password.

B-JAVA-15.png

The installation starts.

B-JAVA-16.png

Installation is completed. It tells you where it has been installed.

B-JAVA-17.png

Finally, you are asked to Keep or Move the installation package to the bin. Do as you wish here.


4. Check that Java now shows up in the Terminal window.

Type "Java -version".

B-JAVA-18.png

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

B-JAVA-19.png

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


Installation of Ancestris

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



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