Title: Installing TeamPage on macOS

This document describes how to install TeamPage 7.0 or later on macOS.

Download



On the TeamPage installer download site, click the "Download macOS Universal" button to download the installer.



Verify the File Integrity (Optional)



The SHA-256 checksum appears beneath the download button. Put your mouse over it to show the full value and copy it to your clipboard.



When the download completes, you can open a command prompt and use the sha256sum command to verify that the signature matches the expected value.

funzone (shep) ~/Downloads → echo "63f3f963da770c9cbe34a23d0724143fd7a3915d86aafc22c5054e677897737e traction7011.zip" | sha256sum -c                 
traction7011.zip: OK


Unzip and Run the Installer



Double click the .zip file expand it, and then run the installer.

TeamPage installers are signed, but not notarized. macOS will most likely prevent you from running the installer, in which case you will see a dialog like this:



Click OK to dismiss it, then launch your System Settings app. On the "Privacy and Security" panel, scroll down to find a message like "[installer name] was blocked from use because it is not from an identified developer." Click the "Open Anyway" button.



You may then be prompted to authenticate; and then the warning dialog will appear again, but this time with an "Open" button, so click "Open" to finally run the installer.



Installer Steps



First, please read the license agreement. Check the checkbox to accept the agreement, and click "Next" to proceed to the next step.



Choose your desired installation location. (The default will be in the Applications folder.) Then press "Next".



If you have the Traction.lic license file handy, you can choose it now. Otherwise, you'll be prompted to install it from your browser after TeamPage is running. Then press "Next".



Next, you'll choose a Java Runtime Environment (JRE) / Java Virtual Machine (JVM). In almost all cases, you should choose the option to "Install the recommended JVM for me", which should already be selected. If you have been advised by Traction TeamPage support to use a different JRE/JVM, choose the "I want to select the JVM to use myself" option to select the correct location.



Then review the pre-installation summary. If you're satisfied, click "Install" to proceed.



The installation process will take some time, but when it is complete, TeamPage has been successfully installed.

Network Configuration Options



If this is a new installation rather than an update, the installer will now offer you the option to configure some network settings. (You can also set or change these properties from within TeamPage's web-based setup and admin pages.) It is important at least to choose a port that you know is available for TeamPage to use for its HTTP service on the host machine. Click "Next" when you're ready.



A script may launch in a separate command window to apply your requested configuration options. You can close this when it finishes running.

funzone (shep) ~ → /Applications/Traction/traction/server/ConfigureBaseUrl.command ; exit;
http://localhost:8080

Saving session...completed.

[Process completed]


Startup Item



Note: TeamPage installers on most versions of macOS cannot currently create a startup item. The installer will offer you the option during this step, but it will most likely not work. Uncheck the "Configure Startup Item" option and click "Next" to proceed.



Start TeamPage



The installer offers you the option to start TeamPage now, or start it yourself later. Choose your preferred option and click "Next" to proceed.



The installation process is complete, so the installer will close.

You should have a shortcut on your desktop which you can use to launch TeamPage in the background.

You can also open a command prompt and launch TeamPage in the foreground using the command TractionApplication.command in your installation's traction/server folder, e.g.,

funzone (shep) /Applications/Traction/traction/server → ./TractionApplication.command                                                                
StartTraction: No current journal. Skipping lock check.

StartTraction: Lockfile clear. Starting Traction...
Starting Traction TeamPage: No Journal
Version 7.0 (ID 7.011) Sat Feb 01 06:55:50 PST 2025
Licensed to:  Mr. David A. Shepperton of Traction Software, Inc.
License ID:XXXXXXXXX-XXXXXXXXXXX-XXXXX
Nothing to lock.
StartTraction: Starting heartbeat thread.

Initializing server...
TeamPage Server - no journal
Server ready on http://funzone.local:8080  [ No Encryption ]




Attachments:
download-link.png
checksum-copy.png
check-warning.png
system-settings.png
check-warning-with-bypass.png
license-agreement.png
location.png
license-file.png
jvm-selection.png
pre-installation-summary.png
network-settings.png
startup-item.png
start.png
Related Articles
referenced by (1)
Doc141: Installing Traction TeamPage Upgrades
Article: Doc1947 (permalink)
Date: March 1, 2025; 4:34:04 AM Eastern Standard Time

Author Name: Dave Shepperton
Author ID: shep