Logo
Sign in HotDoc Academy Submit request Remote support I'm a patient

  1. HotDoc Support
  2. Installation
  3. How to Install HotDoc

  1. HotDoc Support
  2. Installation
  3. How to Install HotDoc
Print Friendly and PDF   Follow

How to install HotDoc (Best Practice)

Last updated 25 May 2026 23:15   ∙   ~ minute read
Best Practice

You need to install the HotDoc Sidebar and connector service if your practice:

  • Has just signed up to use HotDoc as a service provider
  • Has gone through a server migration or update which has removed the previous instance of HotDoc
  • Has a new or existing workstation that requires the HotDoc Sidebar 

Follow the steps below to be taken through the system requirements needed for HotDoc and the installation instructions.
 

   In this article 

  • How to install if you are new to HotDoc or have performed a server migration/update
    • Before you start
    • Install the HotDoc Sidebar on your Server
    • Allow HotDoc as a third-party integration in Best Practice and provide access to Halo Connect
    • Configure HotDoc with Best Practice
  • How to install HotDoc on a new workstation (not server)

 

How to install if you are new to HotDoc or have performed a server migration/update

If you are planning a server migration or update, please notify the Halo Connect team before the migration date so they can update their configuration accordingly.

Once the new server has been set up, please follow the steps in Configure HotDoc with Best Practice to update your server path.

ⓘ Are you changing servers?

 

Before you start 

Before installing HotDoc, make sure your server and Best Practice environment meet the requirements below. 

If you're unsure about any of these, your IT provider will be able to assist. 


Best Practice requirements

HotDoc connects to Best Practice using Halo Connect.

Before continuing, ensure:

  • You are not in Evaluation Mode in Best Practice
  • Halo Link is up and running and configured with Best Practice
  • Your version of Best Practice supports Halo Connect
  • You are running the latest Best Practice Data Update

You can download the latest Best Practice Data Update here.


Operating system requirements

HotDoc version 3.3.x and above requires:

  • Windows 8, Windows 10, Windows Server 2012 or later
  • .NET Framework 4.5 or later

The following operating systems may experience compatibility issues:

  • Windows XP
  • Windows Vista
  • Windows Server 2003
  • Windows Server 2008 R1

If you are using one of these operating systems, contact HotDoc Support before installing.

Firewall and network requirements

If your firewall blocks connections by default, your IT provider will need to add the following domains to the allow list on your firewall: 

  • *.hotdoc.com.au
  • *.pubnub.com
  • au-com-hotdoc.s3.amazonaws.com
  • au-com-hotdoc-ember-production.s3.amazonaws.com
  • d4c51m54o196o.cloudfront.net
  • maps.googleapis.com

Install the HotDoc Sidebar on your Server

  1. Log in to your server using an administrator account.
     
  2. Download the HotDoc installer using this link.
     
  3. Run the installer and follow the prompts (leave all defaults unless you require a different install directory)
     
  4. When the installation is complete, a shortcut should appear on your desktop. Please double-click the sidebar shortcut to open the sidebar.

    Screen_Shot_2020-01-30_at_3.53.07_pm.png
     
  5. Log in to the HotDoc Sidebar using your Clinic User (the email you received your user invitation to, as well as the password that you set).
     
  6. Click Open Dashboard, and a new window will open with the HotDoc Dashboard login page:

    Monosnap Illustration of White Blood Cell …ute Character Illustration - Logo 2026-05-11 14-36-12.png

     
  7. Log into the HotDoc Dashboard with the same Clinic User details you used for the Sidebar.
     

Allow HotDoc as a third-party integration in Best Practice and provide access to Halo Connect
 

  1. In Best Practice, go to  Setup > Configuration > Database > Setup third-party integrations.
Monosnap RJ BP clinic 2026-05-08 16-17-52.png
Monosnap RJ BP clinic 2026-05-08 16-16-44.png

 

  1. Tick HotDoc (via Halo Connect), then click Generate pairing code

    Monosnap Illustration of White Blood Cell …ute Character Illustration - Logo 2026-05-11 16-16-25.png

     
  2. Copy the Site ID and the Pairing Code
    Site ID + Pairing Code.png
     
  3. After copying the codes, click Save

    Monosnap Illustration of White Blood Cell …ute Character Illustration - Logo 2026-05-08 16-39-58.png

     
  4. In the HotDoc Dashboard, go to Setup > Install HotDoc

    Monosnap HotDoc Academy Clinic 2025-11-18 10-54-11.png

     
  5. In the Enable Halo Connect Integration section, paste the Site ID from Best Practice

    site ID1.png
  6. Paste the Pairing Code from Best Practice

    Paring Code 1.png
     
  7. Click Connect
    Monosnap Grace Anatomy 2026-02-03 15-37-57.png
     
     

Configure HotDoc with Best Practice

  1. Once Halo Connect has been connected, scroll down on the same page of the Dashboard (Setup > Install HotDoc).
     
  2. Ensure the correct timezone is selected

    Monosnap HotDoc Academy Clinic 2026-05-11 14-18-54.png
     
  3. Set your server path:

    Monosnap HotDoc Academy Clinic 2026-05-11 14-19-14.png
    Note: You can use the ‘Use this device’ option to set your ‘Server path’ to the current machine's computer name if you are currently installing on the server.

     
  4. Select your integration method:
     
    • If you are running BP Jade or above, check the box that reads I have enabled HotDoc in the Best Practice Third-Party Integrations dialog - see: Best Practice Jade/Saffron Integration for more information.

      Monosnap Millthorpe Medical Practice 2026-05-11 14-29-03.png
       
  5. Select Save at the bottom right-hand corner of the page

    Monosnap Millthorpe Medical Practice 2026-05-11 14-29-51.png

  6. If you are sure the Server path is correct, select Yes, Save

    Monosnap Millthorpe Medical Practice 2026-05-11 14-30-34.png  
  7. Once complete, if successful, you should see a green Connected light in the Sidebar:

    Monosnap Illustration of White Blood Cell …ute Character Illustration - Logo 2026-05-11 14-34-52.png
     
  8. If you encounter any issues, please contact HotDoc Support for further assistance.
     

How to install HotDoc on a new workstation (not server)

We recommend that the HotDoc Sidebar be installed on all workstations at the practice

  • After completing the server installation, please see How to download the HotDoc Sidebar to download the Sidebar onto any workstation.
     
  • Sidebars on workstations do not need to be logged into 24/7, so doctors, reception and administrative teams are free to shut down their stations at the end of the day.
Was this article helpful?
Submit Feedback

17 out of 31 found this helpful

Related articles

  • How to download or update the HotDoc Sidebar
  • Why does the Sidebar say 'No PMS'?
  • Online Bookings - The Patient Journey
  • How to install the HotDoc Sidebar on Practitioners' workstations
  • Why is our new practice management software not syncing with HotDoc?

Related articles

  • How to download or update the HotDoc Sidebar
  • Why does the Sidebar say 'No PMS'?
  • Online Bookings - The Patient Journey
  • How to install the HotDoc Sidebar on Practitioners' workstations
  • Why is our new practice management software not syncing with HotDoc?
© 2023 HotDoc Online Pty Ltd | Terms of Service | Privacy Policy | Contact Us
© 2023 HotDoc Online Pty Ltd

Terms of Service | Privacy Policy