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.
Installation of Java
1. From the macOS desktop...
2. Open a terminal and type "java -version" to check if Java is already installed or not.
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.
Otherwise, if Java is not installed, the response will indicate that Java cannot be located.
So install it by following these next steps.
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.
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".
Downloading has started... Click the download round button on your browser and wait.
After a short moment, downloading is completed.
Launch the JDK package from this download popup. You should see this installation window.
Click Continue.
Click Continue.
Click Agree.
Click Install.
Validate with your fingerprint or provide your Mac password.
The installation starts.
Installation is completed. It tells you where it has been installed. Click Close.
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".
The following result should appear, indicating Java 21 is installed.
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
You are taken to the Download section of the web site.
Click the Ancestris 13 button for macOS column. Version 13 is the latest one since June 2024.
Download starts. Click the Download round button of your browser to see the progress bar and wait.
When completed, you should see the Ancestris package is approximately 94 MB.
Launch it from this popup window by clicking the little "Open" icon.
The Ancestris installation window should appear.
Click Continue.
Click Install.
Confirm with your fingerprint or provide your Mac password.
Installation proceeds...
The installer asks for your permission to put the files on your computer. Press Allow.
The installation completes quickly. Press Close.
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.
Ancestris starts.
The main Ancestris window then appears. You are done with the installation.
The language of the interface should automatically be set to your system language.
Congratulations.