Sunix Installation Guide

Step-by-step guide to install Your Booking for a practice on Sunix Vision.

Overview

Your Booking is an online appointment booking system for optometry practices using Sunix Vision. A lightweight agent runs on your practice server, reads from and writes to your existing Sunix data files, and connects securely to the Your Booking platform. No patient data is stored outside your practice.

Prerequisites

No Sunix Vision changes required. The agent reads and writes Sunix's data files directly. Sunix doesn't need to be reconfigured, doesn't need to be running, and doesn't need to be stopped during installation. Staff can keep using Sunix Vision throughout.

Step 1: Locate your Sunix install

Before installing, find two folders. You'll need their paths during installation.

1.1 Sunix Vision folder

This is the folder containing v2000.exe — the main Sunix Vision program. Common locations:

The installer will try to auto-detect this folder. If it can't find one, you'll need to pick it manually. You can find it by right-clicking the Sunix Vision shortcut on your desktop and choosing Open file location.

1.2 Sunix Data folder

This is the folder containing your practice's Sunix data files. It's almost always a subfolder called Data under the Sunix Vision folder — for example C:\v2k\Data or V:\v2k\Data. The installer will guess this for you based on the Vision folder. If you open it in Windows Explorer you'll see many files; that's the right folder.

If your data folder is on a different drive or share, browse to its actual location.

1.3 Best machine for the agent

Install the agent on the server PC that owns the Sunix data folder if possible. The agent will be most responsive when the data folder is a local path (C:\…) rather than a mapped share or UNC path. Workstation installs work too, but every read and write goes over the network.

Step 2: Install the Agent

2.1 Download and run the installer

Download the installer from:

https://yourbooking.au/downloads/YourBookingAgent-Sunix-Setup.exe

Run it on the chosen machine.

2.2 Choose install location

The default location is C:\Program Files\YourBookingAgent-Sunix. You can change this if needed. (The Optomate flavour installs to a separate folder, so both can coexist on the same machine if you ever migrate.)

2.3 Enter practice details

The installer will prompt for:

SettingDescription
Licence KeyYour practice licence key (provided during onboarding)
Sunix Vision folderFolder containing v2000.exe (see Step 1.1). The installer pre-fills this if it can find Sunix automatically.
Sunix Data folderFolder containing your Sunix data files (see Step 1.2). Pre-filled as <Vision folder>\Data.

The installer validates both folders before it lets you continue — it'll tell you if v2000.exe is missing from the Vision folder or the data folder doesn't exist.

2.4 Complete installation

The installer will:

Step 3: Verify

Open your practice's booking page (e.g. yourpractice.yourbooking.au) in a browser.

Step 4: Set Up Your Booking

Once the agent is installed and connected, follow the Setup Guide to configure the booking system. This covers:

Online booking is off by default, so you can take your time configuring everything before patients can see the booking page.

Appointment types come from Sunix. Your Booking reads your existing Sunix appointment-type list automatically — you don't need to mark types as "available for online booking" inside Sunix. You'll choose which types appear online from the Your Booking admin instead.

Optional: send patient emails from your own address

By default, patient emails (booking confirmations, reminders, recalls, follow-ups) come from obs@yourbooking.au with your reception address as the reply-to. If you'd rather have them come from your own domain (e.g. info@yourpractice.com.au) using your existing Google Workspace / Microsoft 365 / SMTP credentials, see the Practice Email Setup guide. IT may need to be involved for App Passwords or "Send As" alias setup.

Step 5: Add to Your Website

To embed the booking page on your website, see the Website Integration Guide. It covers the iframe embed code, configuring email links, and optional redirect rules for SMS/recall links.

In-store kiosk (iPad)

Set up a tablet in the waiting room so patients can book themselves when staff are busy.

  1. Open https://yourpractice.yourbooking.au/?kiosk in Safari on the iPad
  2. Tap Share (square with arrow) then Add to Home Screen
  3. Name it (e.g. "Book Appointment") and tap Add

The app launches full-screen with no browser chrome. It shows a welcome screen with the practice logo and a "Book an Appointment" button. After a booking completes or 2 minutes of inactivity, it resets back to the welcome screen for the next patient.

iPad setup for shared use:

Disable autofill so patients don't see each other's saved information:

Add to phone home screen

Patients can add the booking page to their own phone's home screen by visiting https://yourpractice.yourbooking.au/ directly and choosing "Add to Home Screen". This gives them a branded app icon and a full-screen booking experience. If you've uploaded a square icon in Branding → Square icon, that's used for the home-screen icon — otherwise your main logo is used (which may look cropped on square icon slots).

Patients who visit the booking page via your own website (the embedded iframe) need the additional manifest setup described in the Website Integration GuideStep 4: Add to Home Screen to get the same experience.

Firewall

The agent only makes outbound connections. No inbound firewall rules or port forwarding are required.

If your network has outbound filtering, ensure the server can reach:

Changing Configuration

To change the Sunix folder, data folder, or other settings:

  1. Edit the .env file in the install directory (e.g. C:\Program Files\YourBookingAgent-Sunix\.env)
  2. Restart the service using one of:
    • Windows Services: open services.msc, find "Your Booking Agent (Sunix)", right-click → Restart
    • Command line: open a command prompt as Administrator in the install directory and run winsw restart

Logs

Agent logs are at logs\winsw.err.log in the install directory. To view:

type "C:\Program Files\YourBookingAgent-Sunix\logs\winsw.err.log"

Log files rotate automatically at 5MB.

Service Management

The agent runs as a Windows service called YourBookingAgentSunix (displayed as "Your Booking Agent (Sunix)" in the Services console). You can manage it from the Windows Services console (services.msc) or from the command line:

winsw start
winsw stop
winsw restart
winsw status

Run these from the install directory (e.g. C:\Program Files\YourBookingAgent-Sunix).

Uninstalling

Use Add or Remove Programs in Windows Settings, or run the uninstaller from the Start Menu. This stops the service, removes it from Windows, and deletes all installed files. Your Sunix data is untouched.

Troubleshooting

Agent won't start

"Cannot read Sunix data" / "Permission denied"

Booking page shows "agent offline"

Booking shows "temporarily unavailable"

Sunix shows old data after a booking