Installation - Migrating the MacPractice Server

Moving the MacPractice Server, typically called a server migration, is a process that involves creating a backup of the MacPractice database and using that backup to restore the database to a new computer with the MacPractice Server software installed. This document will outline completing a server migration and connecting the terminal computers. If at any point you feel uncomfortable following these steps, do not hesitate to call MacPractice Support, as we are more than happy to guide you through the process.

Installing the Server MacPractice Application
Whether the planned server is a new computer or an existing MacPractice client terminal, you will need the following:
  • A current backup: The MacPractice Backup guide can assist with creating a backup. This backup should be transferred to the new server.
  • A MacPractice Server Installation: This can be obtained from The Installing MacPractice on the Server guide can assist with the installation process.
  • Plenty of free hard disk space: At the bare minimum, we recommend you have three to five times the size of the current backup on the destination server, with more space definitely preferred. This is to accommodate reconstructing the database from the current backup, and accommodating room for future backups and the growth of your database. For questions on this front, please contact MacPractice Support.
  • On MacPractice Builds 12.11 and higher, you'll need to set up your Server Management App user to allow you access to administrative functions for the MacPractice Server. You can read more about the Server Management App here.
  • If you are on MacOS Catalina and on a build of MacPractice earlier than 12.11, you'll need to run the Catalina start up script in order to start MacPractice and prior to restoring from a backup. You can read more about it here.
Restoring the MacPractice Backup
Once the Server installation is complete, you'll be able to restore your database. There are two methods that depend on what build of MacPractice you're on.
The following instructions are for MacPractice Builds earlier than 12.11. If you're looking for instructions on Build 12.11 and higher, you'll need to refer to the Server Management App article, located here. 
On builds prior to 12.11, you can restore a database by first clicking the gear icon to switch to the Database Connection Configuration view from the MacPractice login window.
To adjust the Database Configuration fields, click the Lock icon and enter the computer's administrative username and password. Next, click the Restore Database button.

The Security Password Required window will appear if the server has been restarted. This password is the Encryption Security password that was created during the initial installation of MacPractice. Enter the password and click the OK button.

The resulting Operating System authentication window may request the computer's Administrator username and password again.

In the resulting window, locate the MacPractice database to be restored and click Open. You may be asked to create a new database. This prompt simply is saying it will be creating a new database from the backup we have selected. If you receive this prompt, click the Continue button.

A warning will pop up, verifying that the database will be restored. There is a check box to affirm whether or not this restoration is for the main production database.


If the box is checked, when Restore is clicked, another pop up will appear, alerting that the database restoration will keep its current settings.


If the box is unchecked, the following information will not be brought forward when restoring the backup:

  • Autoremind User
  • Username
  • eStatement Password
  • Medavant PP Password
  • Demandforce Configuration information
  • NEA
  • UpDox Faxing user and password
  • Direct Messaging user information
  • Phone numbers and e-mails for all patients

Once the restoration process starts, do not force quit while MacPractice is restoring.

Authentication may be required during this process.

Once MacPractice has completed the restoration process, restart MacPractice with the Restart button. To log back in to MacPractice, enter the MacPractice Admin username and password. The database may need updated before continuing.

Connecting Clients to the New Server
Click the MacPractice icon on the computer's Dock to open the MacPractice Login window. From the Login window, click the gear icon to view the Database Connection Settings and click the lock to make changes. Enter in the IP Address of the MacPractice Server computer along with the name of the MacPractice database.


Each MacPractice terminal will need to be paired with the MacPractice Server using a passcode presented on the device. When a MacPractice terminal attempts to connect to the MacPractice Server, a 4 digit passcode is generated and remains open for 60 minutes. Print the instructions, which include the passcode and the expiration time.


On the MacPractice Server, add the passcode in Preferences > Database Access as shown in the printed instructions. The device will be added to the Database Access list and paired with the MacPractice Server.


If you experience difficulties connecting the MacPractice Client to the MacPractice Server, please see the MacPractice Network documentation.

Was this article helpful?
0 out of 0 found this helpful