The MacPractice Server computer hosts the MacPractice database to which each of your MacPractice Clients will connect. Certain functions will only work on the server, such as the database backup. Please make sure the MacPractice Server is able to log in to MacPractice before installing MacPractice on the terminal computers.
The MacPractice Server installer will install MySQL, the MacPractice application, the background application MacPracticeServer, the MacPractice Frameworks, and all other components that are necessary for MacPractice to run as a server on your office computer.
After the MacPractice Server installer has downloaded, click the zip file with the extension .mpkg.tar.gz to extract the MacPractice Installer. The Finder window will open, displaying the Desktop contents. Double click the .mpkg (orange box) to start the installation process for the MacPractice Server. Depending on your system preferences, you may need to right click and select Open, then agree to open the installer package. The MacPractice installer will run a quick verification test to make sure that MacPractice can be installed on the designated computer. After the verification test has completed, the installation process will continue.
Run the Installer
In the Installer window, you should see an Introduction and a Read Me page. Click the Continue button. A page will open for chat support assistance as well.
Read through the Software License Agreement and click the Continue button. Next, click Agree to agree to the license agreement and continue with the installation.
The Installer will next ask you to select a backup to verify that you have a current backup of MacPractice. If this is your first installation and you do not have a MacPractice backup, click Continue. You will see an alert. Click OK, then click Continue again to skip the backup verification. This should only be skipped with new installations; do not skip this step if you have data in your MacPractice database. The backup is vital to your installation of MacPractice and needs to be current. If a current backup is not available, stop the installation and create a current backup, then restart the installation.
Note: For MacPractice Gen 9, the Select Backup prompt has been removed. You should still double-check that you have a backup any time you are installing or updating MacPractice unless this is your first MacPractice installation.
After you have verified your backup is current or skipped this step, click the Continue button to continue the installation. Confirm you are installing MacPractice on your local hard drive, then click the Install button. Enter an Administrator username and password for the server computer, then click OK.
During the installation, create the MacPractice Security Password, which will be used to access the MacPractice database each time server computer has been restarted. This password will need to be input each time your server is rebooted to access your MacPractice database. It is strongly recommended that the password you choose is different from the other passwords on the computer and that more then one person in the office knows this password. The MacPractice database will not be accessible without the MacPractice Security password.
Next, enter the serial number that was sent to the office in the initial welcome email, and click the Continue button to continue with the installation.
The installer will make the necessary file changes to install MacPractice and MySQL. Do not force quit or interrupt the installation process.
When the installation process has completed you should see a message indicating the installation was successful. Click Restart to exit the installer. Your computer will reboot, completing the installation process.
If your computer does not restart please do so manually. Until the computer restarts, the MacPractice MySQL installation will not be complete.
Next, access System Preferences from the Apple menu to add all computer user to the newly created MacPractice Account Groups. From the System Preferences window, select Users & Groups.
Click the lock in the lower left corner of the System Preferences window to make changes to the groups. Enter the computer administrative user's username and password. This is the username and password for the computer, not for the MacPractice application. Add all users that will need to create or access MacPractice backups to the macpractice_backup group. Exit the System Preferences to save these settings.
Go to the computer's Applications folder, select the MacPractice folder, and drag the MacPractice application icon to the Dock.
Launch the Application
Click the MacPractice icon to open the MacPractice Login window. When prompted, enter the MacPractice Security password created during the installation process.
The gear icon on the top right of the login window allows access to the Database Connection Setting view. The server computer must have a Server IP Address of localhost. The Database Name will usually be macpractice. If this information needs to be adjusted, click the Lock icon and enter the computer's Administrator username and password to adjust.
From this point in the installation process, you can either start with a blank database, or restore an existing MacPractice data file. Please continue to the appropriate documentation by clicking either link: