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


Otherwise, 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


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 provide 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. Click Close.

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.

B-JAVA-19.png

You 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

C-Ancestris-01-en.jpg


In the menu, click on DOWNLOAD. 

C-Ancestris-02-en.jpg


You are taken to the Download section of the web site.

C-Ancestris-03-en.jpg


Click the Ancestris 12 button for MacOS column.

C-Ancestris-04-en.jpg


Download starts. Click the Download round button of your browser to see the progress bar and wait.

C-Ancestris-05.png


When completed, you should see the Ancestris package is approximately 94 MB.

C-Ancestris-06.png


Launch it from this popup window by clicking the little "Open" icon.

C-Ancestris-07.png


The Ancestris installation window should appear.

C-Ancestris-08.png

Click Continue.

C-Ancestris-09.png

Click Install.C-Ancestris-10.pngConfirm with your fingerprint or provide your Mac password.

C-Ancestris-11.png

Installation proceeds...

C-Ancestris-12.pngThe installer asks for your permission to put the files on your computer. Press Allow.

C-Ancestris-13.png

The installation completes quickly. Press Close.

C-Ancestris-14.png

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


6. Launch Ancestris from the Application launchpad screen.

In your application Launchpad screen, Ancestris should appear among the other applications. Launch it.

C-Ancestris-15.png


Ancestris starts.

C-Ancestris-16.jpg


The main Ancestris window then appears. You are done with the installation.

C-Ancestris-17.jpg


The language of the interface should automatically be set to your system language.

Congratulations.